A high-performance, extensible, and production-ready WhatsApp Userbot Framework built on top of the Astra Engine. Designed for developers who need power, modularity, and efficiency.
Deploy Astra Userbot instantly on your preferred platform:
For Localhost, Docker, and VPS setups, refer to the Deployment Guide (DEPLOYMENT.md).
Astra Userbot is powered by the Astra Engine Core, which handles:
- Plugin loading
- Event routing
- System automation
- Lifecycle management
Core Library Repository:
Extend or remove features using the commands/ directory.
Powered by Google's Gemini 3 Flash Preview models.
Supports downloading from: - YouTube - Instagram - Other media
platforms
via a JS-based media bridge.
Stores: - AFK states - Sudo users - Permissions - Notes / custom tags
- Clean Python code
- Automated environment setup
- Clear module structure
- Error-resilient engine
Run as Administrator:
iwr -useb https://raw.githubusercontent.com/paman7647/Astra-Userbot/master/install.ps1 | iexbash <(curl -fsSL https://raw.githubusercontent.com/paman7647/Astra-Userbot/master/install.sh)For Docker & cloud installations, consult DEPLOYMENT.md.
- Copy the example environment file:
cp .env.example .env- Open
.envand add:
Variable Description
GEMINI_API_KEY Google AI API key
OWNER_WHATSAPP_ID Example: 910000000000@c.us
python3 bot.pypython3 bot.pyCommand Alias Description
.alive --- Shows system status & uptime
.ai .chat Chat with Gemini AI
.yt .youtube Download YouTube video/audio
.ig .reel Download Instagram posts/reels
.ping --- Check bot latency
Astra-Userbot/
│── bot.py # Main launcher
│── commands/ # Modular plugin commands
│── utils/ # Utility modules and configs.
│── .env.example # Example config
└── install.sh / install.ps1
Licensed under the MIT License.
See LICENSE for complete details.