Skip to content

coddrago/Heroku

 
 

Repository files navigation

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
En Ru

Manual Installation (VPS/VDS Server)


⚠️ 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

VPS/VDS

Note for VPS/VDS Users:
Add --proxy-pass to enable SSH tunneling
Add --no-web for console-only setup
Add --root for root users (to avoid entering force_insecure)

Ubuntu / Debian
sudo apt update && sudo apt install git python3 -y && \
git clone https://github.com/coddrago/Heroku && \
cd Heroku && \
python3 -m venv .venv && \
source .venv/bin/activate && \
pip install -r requirements.txt && \
python3 -m heroku
Fedora
sudo dnf update -y && sudo dnf install git python3 -y && \
git clone https://github.com/coddrago/Heroku && \
cd Heroku && \
python3 -m venv .venv && \
source .venv/bin/activate && \
python3 -m pip install -r requirements.txt && \
python3 -m heroku
Arch Linux
sudo pacman -Syu --noconfirm && sudo pacman -S git python --noconfirm --needed && \
git clone https://github.com/coddrago/Heroku && \
cd Heroku && \
python3 -m venv .venv && \
source .venv/bin/activate && \
python3 -m pip install -r requirements.txt && \
python3 -m heroku

Other

WSL(Windows)

⚠️ WARNING: Can be unstable!

  1. Download WSL. For this open window PowerShell with admin rights and write in console
wsl --install -d Ubuntu-22.04

⚠️For install beed Windows 10 build 2004 or Windows 11 of any version and PC with virtualization support. For installation on earlier OS, please refer to this page.

  1. Restart PC and start programm Ubuntu 22.04.x
  2. Enter this command(RMB):
curl -Ss https://bootstrap.pypa.io/get-pip.py | python3

⚠️ If yellow warnings appear, enter export PATH="/home/username/.local/bin:$PATH" replacing /home/username/.local/bin with the path mentioned in the message

  1. Enter this command(RMB):
clear && git clone https://github.com/coddrago/Heroku && cd Heroku && python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt && python3 -m heroku

🔗How to get API_ID and API_HASH?: Video

Phone(Userland)
  1. Install UserLAnd from the link
  2. Open it, choose Ubuntu —> Minimal —> Terminal
  3. Wait for the distribution to install, you can pour some tea
  4. After successful installation, a terminal will open in front of you, write there:
sudo apt update && sudo apt upgrade -y && sudo apt install python3 git python3-pip -y && git clone https://github.com/coddrago/Heroku && cd Heroku && python3 -m venv .venv && source .venv/bin/activate && sudo pip install -r requirements.txt && python3 -m heroku
  1. At the end of the installation, a link will appear, follow it and enter your account details to log in.

Voila! You have installed Heroku on UserLAnd.

Official hostings

🌘 HikkaHost
  1. Go to @hikkahost_bot
  2. Press "Install"
  3. Choose "🪐 Heroku" And continue installation.

After that, you will receive a link, open it and login in your account.

⬇️ Lavhost

To install, just go to @lavhostbot and follow these steps:

  1. Enter the command /buy, select and pay the invoice
  2. Send the payment receipt if required
  3. After payment confirmation, type /install and select Heroku
  4. Follow the bot's instructions
🧃Jamhost
  1. Go to @jamhostbot and write the command /pay
  2. Pay for the subscription on the website
  3. After payment, write the command /install to the bot, select " 🪐 Heroku " in the list of userbots and select the desired server
  4. Log in using the link provided by the bot

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


📚 Documentation

Type Link
User Documentation heroku-ub.xyz
Developer Docs dev.heroku-ub.xyz

💬 Support

Telegram Support


⚠️ 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

🙏 Acknowledgements

  • Hikari for Hikka (project foundation)
  • Lonami for Telethon (Heroku-TL backbone)

Packages

 
 
 

Contributors

Languages

  • Python 95.5%
  • JavaScript 1.7%
  • CSS 1.3%
  • Other 1.5%