Next-generation modular Telegram userbot with enhanced security, rich inline UI, and modern features.
Elys is an advanced, high-performance, and modular Telegram userbot developed by ZavozDevs, powered by Python 3 and asynchronous Telethon.
Whether you want to automate routine messaging, manage groups and channels, add interactive inline widgets, or run custom plugins, Elys Userbot delivers unmatched flexibility and speed. It comes with out-of-the-box compatibility for Hikka, Friendly-Telegram (FTG), and GeekTG modules.
- ⚡ Blazing Fast & Lightweight: Asynchronous architecture built for low resource consumption on VPS, servers, or local devices.
- 🧩 Modular Ecosystem: Easily install, update, and manage community modules using simple commands (
.dlmod,.help). - 🎨 Modern Interactive UI: Rich inline keyboards, menus, dynamic galleries, and full support for the latest Telegram features (forums, topics, reactions).
- 🛡️ Enhanced Security: Native API firewall, entity caching, permission safeguards, and malicious module detection.
- 🔄 Full Compatibility: Run your favorite modules from Hikka, FTG, and GeekTG without modifications.
- ☁️ Cloud Ready: Deploy anywhere in minutes — VPS, Docker, WSL, Android (UserLAnd / Termux), or 1-click cloud hosting via RnHost.
Important Security Advisory
While Elys 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.)
Note for VPS/VDS Users:
Add--rootfor root users (to avoid entering force_insecure)
Ubuntu / Debian
sudo apt update && sudo apt install git python3 -y && \
git clone https://github.com/ZavozDevs/Elys && \
cd Elys && \
python3 -m venv .venv && \
source .venv/bin/activate && \
pip install -r requirements.txt && \
python3 -m elysFedora
sudo dnf update -y && sudo dnf install git python3 -y && \
git clone https://github.com/ZavozDevs/Elys && \
cd Elys && \
python3 -m venv .venv && \
source .venv/bin/activate && \
python3 -m pip install -r requirements.txt && \
python3 -m elysArch Linux
sudo pacman -Syu --noconfirm && sudo pacman -S git python --noconfirm --needed && \
git clone https://github.com/ZavozDevs/Elys && \
cd Elys && \
python3 -m venv .venv && \
source .venv/bin/activate && \
python3 -m pip install -r requirements.txt && \
python3 -m elysWSL (Windows)
⚠️ WARNING: Can be unstable!
- Download WSL. For this open PowerShell with admin rights and write in console:
wsl --install -d Ubuntu-22.04
⚠️ Requires Windows 10 build 2004 or Windows 11 and a PC with virtualization support. For installation on earlier OS versions, please refer to the official manual.
- Restart PC and launch Ubuntu 22.04.x
- Install pip:
curl -Ss https://bootstrap.pypa.io/get-pip.py | python3
⚠️ If warnings appear, enterexport PATH="/home/username/.local/bin:$PATH"replacing with your actual path.
- Run Elys:
clear && git clone https://github.com/ZavozDevs/Elys && cd Elys && python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt && python3 -m elys🔗 How to get API_ID and API_HASH?: Video Guide
Phone (UserLAnd / Android)
- Install UserLAnd from Google Play
- Open it, choose Ubuntu —> Minimal —> Terminal
- Wait for the distribution to install
- In the terminal, run:
sudo apt update && sudo apt upgrade -y && sudo apt install python3 git python3-pip -y && git clone https://github.com/ZavozDevs/Elys && cd Elys && python3 -m venv .venv && source .venv/bin/activate && sudo pip install -r requirements.txt && python3 -m elys- Follow the on-screen instructions to authorize your Telegram account.
Done! Elys is running on your Android device.
Phone (Termux)
- Install Termux from GitHub Releases or F-Droid (do not use Google Play version).
- Launch Termux and run:
pkg update -y && pkg install git python -y && git clone https://github.com/ZavozDevs/Elys && cd Elys && pip install -r requirements.txt && python3 -m elys- At the end of the installation, follow the web link or complete authorization in the terminal.
🪐 Voila! You have installed Elys on Termux.
❤️🔥 RnHost (1-Click Deployment)
- Open host.rooni.dev
- Deploy 🌟 Elys Userbot
- Enter your account details to log in.
Easy, fast and 24/7 cloud hosting for Elys!
🔒 Automatic Database Backuper
👋 Welcome Installation Screens
| Feature | Description |
|---|---|
| 🆕 Latest Telegram Layer | Support for forums, topics, reactions and newest Telegram features |
| 🔒 Enhanced Security | Native entity caching, permission checks and targeted security rules |
| 🎨 UI/UX Improvements | Modern responsive interface and smooth user experience |
| 📦 Core Modules | Improved built-in modules and extended utility commands |
| ⏱ Rapid Bug Fixes | Active maintenance and faster issue resolution |
| 🔄 Backward Compatibility | Seamless support for FTG, GeekTG and Hikka modules |
| Dynamic forms, interactive galleries, and interactive lists |
- Python 3.10+
- API Credentials (API ID and API HASH from my.telegram.org/apps)
| Platform | Link |
|---|---|
| Telegram Support & Chat | @ElysTalk |
| Cloud Hosting | host.rooni.dev |
| Bug Reports & Issues | GitHub Issues |
This project is provided as-is. The developer takes NO responsibility for:
- Account bans or restrictions
- Message deletions by Telegram
- Security issues from untrusted third-party modules
- Session leaks from malicious scripts
Security Recommendations:
- Enable
.api_fw_protection- Avoid installing untrusted modules
- Review Telegram Terms of Service
- Codrago for Heroku Userbot
- Hikari for Hikka Userbot (project foundation)
- Lonami for Telethon