Heroku Userbot is an advanced Telegram userbot built on the Hikka/Telethon ecosystem, offering enhanced security, support for the latest Telegram features, and compatibility with existing FTG/GeekTG/Hikka modules.

Stars

25

7-day growth

No data

Forks

3

Open issues

1

License

AGPL-3.0

Last updated

2026-08-01

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines modern Telegram layer support with a security-focused design and backward compatibility with multiple existing userbot ecosystems, while providing straightforward installation paths for servers, WSL, phones, and hosting bots.

Who it is for

  • Telegram power users who want a self-hosted userbot
  • Users migrating from FTG, GeekTG, or Hikka who need module compatibility
  • Developers building or testing Telegram automation modules
  • People who want to run a userbot on a VPS, WSL, or Android via UserLAnd

Use cases

  • Automate a Telegram account with custom commands and modules
  • Run an inline UI with forms, galleries, and lists
  • Deploy a personal userbot on a VPS/VDS or Android phone
  • Use existing FTG/GeekTG/Hikka modules without rewriting them

Strengths

  • Latest Telegram layer support for forums and new features
  • Security enhancements such as entity caching and targeted security rules
  • Backward compatibility with FTG, GeekTG, and Hikka modules
  • Multiple installation options and official user/developer documentation

Considerations

  • Installing untrusted modules can compromise your server or Telegram account
  • WSL installation is explicitly warned as potentially unstable
  • Project is provided as-is; developers disclaim responsibility for bans, session leaks, or malicious modules

README quick start

Heroku Userbot Advanced Telegram userbot with enhanced security and modern features

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 --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 s

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482