Skip to content

Uroboros

Uroboros

Modular Telegram userbot on Python and Telethon. Modules install with one command, and your account is protected from malicious code.

🚀 Install 🧩 Write modules

  • 📦 One-command modules

    .dlm weather installs a module from the official repo. Add your own repos with .addrepo, search with .search.

  • 🛡 Account protection

    Module code is scanned before install; at runtime modules can't read the session or hijack the account. More

  • 🤖 Buttons and forms

    Built-in inline bot: settings, help and confirmations as buttons right in the chat.

  • 🔁 Hikka and FTG modules

    Hikka and FTG modules load unchanged through the built-in adapter. What's supported

  • 🌿 Stable and dev channels

    master is tested, dev is new. Switch with .dev on / .dev off, rollback on failure.

  • 🐧 Runs anywhere

    Linux and VPS, Termux on Android, Docker, Windows and macOS. Log in via web panel or QR code.

What it looks like

🐍 Uroboros
👤 Account: Evelin
⏱ Uptime: 3d 04:05:06
📦 Modules: 13 · commands: 35
⌨️ Prefix: .
🌿 Branch: master
💡 .help — all commands 12:00 ✓✓
✅ Notes module loaded
💾 .save — save a note
📖 .note — show a note
🗂 .notes — list notes
12:01 ✓✓

Quick start

curl -fsSL https://raw.githubusercontent.com/asykixd/uroboros/master/install.sh | sh

pkg install -y curl && curl -fsSL https://raw.githubusercontent.com/asykixd/uroboros/master/install.sh | sh

git clone https://github.com/asykixd/uroboros && cd uroboros && docker compose up -d

python3 -m venv uroboros && uroboros/bin/pip install uroboros-userbot && cd uroboros && bin/uroboros

The bot opens a web login panel: enter api_id and api_hash from my.telegram.org, phone and code, or log in by QR code. Then type .help in any chat. The bot speaks Russian for now; English is next.

Docs