Heroku Userbot

Advanced Telegram userbot with enhanced security and modern features

Codacy Grade Code Size Open Issues License Commit Activity
Forks Stars Code Style: Black

--- ## ⚠️ Security Notice > **Important Security Advisory** > While Heroku implements extended security measures, installing modules from untrusted developers may still cause damage to your server/account. > > **Recommendations:** > - ✅ Download modules exclusively from official repositories or trusted developers > - ❌ Do NOT install modules if unsure about their safety > - ⚠️ Exercise caution with unknown commands (`.terminal`, `.eval`, `.ecpp`, etc.) --- ## 🚀 Installation ### Manual Installation (VPS/VDS Server) ```bash apt update && apt install git python3 -y && \ git clone https://github.com/coddrago/Heroku && \ cd Heroku && \ pip install -r requirements.txt && \ python3 -m heroku ``` > **Note for VPS/VDS Users:** > Add `--proxy-pass` to enable SSH tunneling > Add `--no-web` for console-only setup ### Additional Features
🔒 Automatic Database Backuper
👋 Welcome Installation Screens
--- ## ✨ Key Features & Improvements | Feature | Description | |---------|-------------| | 🆕 **Latest Telegram Layer** | Support for forums and newest Telegram features | | 🔒 **Enhanced Security** | Native entity caching and targeted security rules | | 🎨 **UI/UX Improvements** | Modern interface and user experience | | 📦 **Core Modules** | Improved and new core functionality | | ⏱ **Rapid Bug Fixes** | Faster resolution than FTG/GeekTG | | 🔄 **Backward Compatibility** | Works with FTG, GeekTG and Hikka modules | | ▶️ **Inline Elements** | Forms, galleries and lists support | --- ## 📋 Requirements - **Python 3.9-3.13** - **API Credentials** from [Telegram Apps](https://my.telegram.org/apps) --- ## 📚 Documentation | Type | Link | |------|------| | **User Documentation** | [heroku-ub.xyz](https://heroku-ub.xyz/) | | **Developer Docs** | [dev.heroku-ub.xyz](https://dev.heroku-ub.xyz/) | --- ## 💬 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support_Group-2594cb?logo=telegram)](https://t.me/heroku_talks) --- ## ⚠️ Usage Disclaimer > This project is provided as-is. The developer takes **NO responsibility** for: > - Account bans or restrictions > - Message deletions by Telegram > - Security issues from scam modules > - Session leaks from malicious modules > > **Security Recommendations:** > - Enable `.api_fw_protection` > - Avoid installing many modules at once > - Review [Telegram's Terms](https://core.telegram.org/api/terms) --- ## 🙏 Acknowledgements - [**Hikari**](https://gitlab.com/hikariatama) for Hikka (project foundation) - [**Lonami**](https://t.me/lonami) for Telethon (Heroku-TL backbone)