The Next-Gen Modular Telegram Framework
Ether is a high-performance, modular Telegram userbot architecture built with Telethon + MongoDB. Designed for developers who prioritize security, speed, and clean code.
Zero String Session Reliance
Unlike traditional userbots that require risky "String Sessions" generated via third-party bots, Ether utilizes a native authentication flow.
- Self-Hosted Sovereignty: Deploy on your own VPS. Your credentials never leave your environment.
- Direct-to-Telegram Login: Use the
/logincommand to trigger an official Telegram OTP/2FA flow directly to your device. - Encrypted Local Storage: Session data is stored securely on your server, not in a cloud database or a developer's logs.
- No Middleware Risks: No Replit, no Heroku logs, and no external session string generators.
- 🛡️ Secure Auth: Native login system (No String Session required)
- ⚡ Hybrid Engine: Leverages Telethon (Userbot) and Bot API simultaneously
- 🔐 Privacy First: Full 2FA support and local session management
- 📦 Plugin Architecture: Easily drop new
.pyscripts into theplugins/folder - 👉 There are many more features — visit the plugins folder or deploy to explore all.
🚀 Render Deployment Guide
🚀 Render Deployment Guide| Variable | Description |
|---|---|
| API_ID | Telegram API ID |
| API_HASH | Telegram API Hash |
| BOT_TOKEN | BotFather Bot Token |
| OWNER_ID | Your Telegram Numeric ID |
| MONGO_URI | MongoDB Connection URI |
- ⭐ Star the repository
- 🍴 Fork Ether to your GitHub account
Click the Deploy to Render button.
Then:
- Login to Render
- Connect GitHub
- Select your forked Ether repository
- Free Plan
python render.py| Key | Value |
|---|---|
| API_ID | Your Telegram API ID |
| API_HASH | Your Telegram API Hash |
| BOT_TOKEN | Your Bot Token |
| OWNER_ID | Your Telegram User ID |
| MONGO_URI | MongoDB URI |
After adding all variables:
✅ Click Create Web Service
⏳ Deployment usually takes around 1–2 minutes
Open @BotFather
- Send
/mybots - Select your bot
- Open Bot Settings
- Enable Inline Mode
Then open your deployed bot and run:
/loginComplete the login process:
- Phone Number Verification
- OTP Verification
- 2FA Password (if enabled)
Use:
.helpto see all available commands.
🚀 JustRunMyApp Deployment Guide
🚀 JustRunMyApp Deployment Guide| Variable | Description |
|---|---|
| API_ID | Telegram API ID |
| API_HASH | Telegram API Hash |
| BOT_TOKEN | BotFather Bot Token |
| OWNER_ID | Your Telegram Numeric ID |
| MONGO_URI | MongoDB Connection URI |
- ⭐ Star Ether
- 🍴 Fork the repository
- 📦 Download repository ZIP
- Login to JustRunMyApp
- Upload the ZIP file
- Wait for processing
- Fill all required environment variables
⏳ Deployment usually takes around 1–2 minutes
Open @BotFather
- Send
/mybots - Select your bot
- Open Bot Settings
- Enable Inline Mode
Then open your deployed bot and run:
/loginComplete:
- Phone Number Verification
- OTP Verification
- 2FA Password (if enabled)
Use:
.helpto see all available commands.
# Update system
sudo apt update && sudo apt upgrade -y
# Install dependencies
sudo apt install python3 python3-pip python3-venv git screen -y
# Clone repository
git clone https://github.com/LearningBotsOfficial/Ether.git
# Open project folder
cd Ether
# Create virtual environment
python3 -m venv venv
# Activate virtual environment
source venv/bin/activate
# Upgrade pip
pip install --upgrade pip
# Install requirements
pip install -r requirements.txt
# Create environment file
nano .env
# Start screen session
screen -S ether
# Start Ether
python main.py
# Detach screen session:
# CTRL + A then D
Ether is source-available software developed by LearningBotsOfficial.
By using, modifying, or sharing this project, you agree to the following terms:
- Original credits to LearningBotsOfficial must remain intact.
- Any public fork or modified version must provide proper attribution to: LearningBotsOfficial/Ether
- Reselling this project or distributing paid/public clones is prohibited.
- Republishing this project under another name without permission is prohibited.
- Personal and private modifications are allowed.
- Use this software responsibly and follow Telegram's Terms of Service.
Failure to follow these terms may result in permission being revoked.
© 2026 LearningBotsOfficial. All rights reserved.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by LearningBotsOfficial