Heroku Userbot 是一款基于 Hikka/Telethon 生态的高级 Telegram 用户机器人,提供增强安全性、最新 Telegram 功能支持,并兼容现有 FTG、GeekTG 和 Hikka 模块。

Stars

25

7 天增长

暂无数据

Fork 数

3

开放 Issue

1

开源协议

AGPL-3.0

最近更新

2026-08-01

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它同时具备最新 Telegram 层支持、安全强化设计,以及对多个现有用户机器人生态的向后兼容性,并且为服务器、WSL、手机和托管机器人提供了清晰的安装路径。

适合谁使用

  • 希望自托管用户机器人的 Telegram 重度用户
  • 从 FTG、GeekTG 或 Hikka 迁移并需要模块兼容的用户
  • 构建或测试 Telegram 自动化模块的开发者
  • 希望在 VPS、WSL 或通过 UserLAnd 在 Android 上运行用户机器人的人

典型使用场景

  • 通过自定义命令和模块自动化 Telegram 账号操作
  • 使用内联表单、画廊和列表构建交互界面
  • 在 VPS/VDS 或 Android 手机上部署个人用户机器人
  • 直接使用现有 FTG/GeekTG/Hikka 模块而无需重写

项目优势

  • 支持最新 Telegram 层,包括论坛等新功能
  • 提供实体缓存和定向安全规则等安全增强
  • 兼容 FTG、GeekTG 和 Hikka 模块
  • 提供多种安装方式以及用户和开发者文档

使用前须知

  • 安装不可信模块可能导致服务器或 Telegram 账号受损
  • WSL 安装方式被明确警告可能不稳定
  • 项目按“现状”提供,开发者不承担封号、会话泄露或恶意模块造成的责任

README 快速开始

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

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
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 与机器学习AI 智能体
2,390
slvDev
精选
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 与机器学习大语言模型
1,960
littledivy
精选
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 与机器学习
1,482