A high-performance, modular Telegram Userbot powered by Pyrofork, PyTgCalls, Yuki API (for YouTube audio extraction without IP blocks), and MongoDB Atlas with in-memory zero-latency caching.
| Module | Commands | Description |
|---|---|---|
| System | .ping, .pong, .alive | Latency benchmarking in ms, uptime, CPU/RAM stats, and operational status. |
| Voice Chat | .vc join, .vc leave | Directly join or leave group voice calls. |
| Music Streaming | .play , .stop | Stream audio into VC via PyTgCalls powered by Yuki API (zero YouTube IP bans). |
| MP3 Downloader | .song , .music | Search, download 320kbps MP3 with thumbnail, and send as Telegram audio. |
| Raid & Spam | .raid | Fire repeated messages with configurable delay. |
| Reply Raid | .rd / .replyraid, .rrd | Target a user; bot automatically counters their messages with roasts. |
| Delay Config | .delay | Adjust global delay interval between operations (saved to MongoDB). |
| Global Mute | .gmute, .ungmute, .gmutelist | Silences user across all chats by instantly auto-deleting their messages. |
| Media Saver | .photo save, .save | Intercepts disappearing/self-destructing timer photos & saves them permanently to Saved Messages. |
| History Tracker | .history, .sg | Queries SangMata to view former display names and usernames. |
| Help Menu | .help | Interactive categorized command viewer. |
�ash cd premium_userbot
�ash pip install -r requirements.txt
Run the interactive generator:
�ash python generate_session.py
This will prompt for your API_ID, API_HASH, and Phone number, send a Telegram login code, and save your STRING_SESSION directly to .env.
Create a .env file (refer to .env.example):
env API_ID=12345678 API_HASH=your_api_hash STRING_SESSION=your_generated_session_string MONGO_URL=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority MEOW_API_URL=https://music.yukiapi.site MEOW_API_KEY=yuki_28d18045448fe0df857d31dfe08fcdef PREFIXES=. ! DEFAULT_DELAY=0.5
�ash python main.py
- Create a new App on Heroku.
- Connect your GitHub repository.
- Add Config Vars in Settings (API_ID, API_HASH, STRING_SESSION, MONGO_URL, MEOW_API_KEY, etc.).
- Deploy the main branch. The included Procfile (worker: python3 main.py) will automatically run the bot.
- Select Dockerfile deployment.
- The root Dockerfile will install fmpeg, libopus, Python dependencies, and run python3 main.py.
- Add your environment variables in the dashboard.
�ash bash deployments/start.sh
Or run with screen / mux:
�ash tmux new -s userbot python3 main.py
�ash pkg install -y git git clone <your-repo> userbot cd userbot bash deployments/termux_install.sh
- Never share your STRING_SESSION or .env file with anyone.
- Avoid excessive raiding or spamming in public groups to keep your Telegram account safe from user reports.