* Ensure root execution Added a check to ensure the script runs with root privileges, and prompt for the root password if necessary. Package manager detection Automatic package manager detection and installation commands. This change simplifies the installation process by automating the detection of the package manager and installing necessary packages accordingly. Added support for multiple package managers such as apt, apk, yum, and pacman. Add repository cloning and environment setup in install.sh Refactored install.sh to improve virtual environment setup, forbid it from executing apt commands without verifying apt presence, added loops for database and installation options. Add repository cloning and environment setup in install.sh Refactored install.sh to improve virtual environment setup, forbid it from executing apt commands without verifying apt presence, added loops for database and installation options. * Update README format and streamline installation instructions Reformatted sections for better readability, removed unnecessary </p>, replaced weird symbols with spaces * spacing * enhnace PM_PERMIT comment * enhance git install instrunction * Enhance repo existence check in installation script Updated the condition to verify both the presence of the directory and essential files (.env.dist, main.py, modules) before proceeding in the existing repository path. This change ensures the script runs only if all required files are available, preventing errors during installation. * Add user prompt for virtual environment creation Introduce a prompt to let the user decide whether to create a virtual environment, providing guidance and the option to skip if needed. * Fixed a typo in options for db_type * Reorder script execution for better flow Moved the execution of `install.py` to ensure configuration prompts occur before running the script. * Update README.md --------- Co-authored-by: Abhi <85984486+AbhiTheModder@users.noreply.github.com>
🌕 Moon-Userbot
A Simple, Fast, Customizable, Ai powered Userbot for Telegram made after Dragon-Userbot abandoned
Warning
The use of this Telegram Userbot is at your own risk, and you are solely responsible for any consequences that may arise from your use of this Userbot. The developer of this Userbot shall not be held liable for any damages or consequences that may occur as a result of your use of this software, whether such use is lawful, unlawful, or malicious. By using this Userbot, you acknowledge that you have read and understood this warning, and that you agree to comply with all applicable laws and regulations, and to use this software responsibly and ethically.
🤖 Ai powers
- Gemini Pro Ai [ ✅ ]
- Ask/Chat with Ai
- Get details from image
- Cooking instructions
- Ai Marketer
- Cohere Coral Ai [ ✅ ]
- Ask/Chat with Ai
- UP-TO Date Info
- Site-Search Support
- Chat History Support
- ChatGPT 3.5 Turbo [ ✅ ]
- Ask/Chat with Ai
- SDXL [ ✅ ]
- DALL-E 3 [ ✅ ]
- Upscaling [✅]
- Text to Image [✅]
🚀 Installation
🏕️ Necessary Vars
API_ID- Get it from my.telegram.orgAPI_HASH- Get it from my.telegram.orgPM_LIMIT- set your pm permit warn limitDATABASE_URL- ONLY for MongoDB, your mongodb urlDATABASE_NAME- set todb.sqlite3if want to use sqlite3 db else leave blankDATABASE_TYPE- set tosqlite3if want to use sqlite3 db else leave blank
⛺ Optional Vars
STRINGSESSION- only If you want to use on cloud hosts use string_gen.py to generate OR
- only If you want to use on cloud hosts use string_gen.py to generate OR
Important
STRINGSESSIONis necessary for deployment through Docker/Cloud Host etc.
-
APIFLASH_KEY- ONLY, If you want to use web screnshot plugin You can get it from here -
RMBG_KEY- ONLY, If you want to use removbg plugin You can get it from here -
VT_KEY- ONLY, If you want to use VirusTotal plugin You can get it from here -
GEMINI_KEY- ONLY, If you want to use gemini ai plugin You can get it from here -
COHERE_KEY- ONLY, If you want to use cohere ai plugin You can get it from here -
VCA_API_KEY- ONLY, If you want to use ai tools like sdxl,upscale plugin You can get it from here
☁️ Cloud Host
| Koyeb | Heroku | Render |
|---|---|---|
- YT Video [How to deploy on Koyeb]: https://youtu.be/2m_yB7EllYc
🐳 Docker
You can either use docker run or docker compose.
Prerequisites
- Docker
- Docker Compose (version 1.x for
docker-compose.yml, version 2.x forcompose.yml) - Put your environment vars in
.envfile check .env.dist for example format
👷♂️docker run:
- Start:
docker run --env-file ./.env -d qbtaumai/moonuserbot:latest - Updating:
then re-run the start command
docker stop $(docker ps -q) && docker rm $(docker ps -a -q)
🍟 docker compose [recommended]:
Docker Compose V1 (docker-compose.yml):
If you're using Docker Compose version 1.x, use the following commands to start and update the service:
- Start:
docker-compose -f docker-compose.yml up -d - Updating & running:
docker-compose -f docker-compose.yml down && docker-compose -f docker-compose.yml pull && docker-compose -f docker-compose.yml up -d
Docker Compose V2 (compose.yml):
If you're using Docker Compose version 2.x, use the following commands to start and update the service:
- Start:
docker compose -f compose.yml up -d - Updating & running:
docker compose -f compose.yml down && docker compose -f compose.yml pull && docker compose -f compose.yml up -d
Important
Make Sure you add appropriate env vars
🖥️ Local Host
🐧 Linux (WSL compatible)
Install Git
There are instructions for installing on several different Unix distributions on the Git website, at https://git-scm.com/download/linux
Clone the repo
git clone https://github.com/The-MoonTg-project/Moon-Userbot.git
Installation
cd Moon-Userbot
chmod +x install.sh
./install.sh
Installer tested on:
- Arch
- Debian
- Ubuntu
- WSL (APT based distros)
Feel free to test on other distros and let us know!
📱 Termux
Tip
Use GitHub version
Full Installation instruction Given here
Note
If you choose MongoDB for your cloud then you need to setup
mongo_db_url**
Recommended: sqlite
🐩 Contributions
Contributions of any type are welcome like custom_modules etc. Feel free to do pull-request's with your changes!
Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub
👨🏻💻 Support
- Channel with latest news on the official telegram [en]
- Modules Channel with custom modules [en]
- Discussion in the official telegram chat [en]
👨🏻💼 Credits
Written on Pyrogram[Pyrofork]❤️ and pytgcalls❤️
Disclaimer
Warning
The use of this Telegram Userbot is entirely at your own risk. The developer of this Userbot is not responsible for any misuse, damage, or legal consequences that may arise from your use of this software.
It is your responsibility to ensure that you use this Userbot in accordance with all applicable laws and regulations, and that you do not engage in any activities that may cause harm to others or violate their privacy. This includes, but is not limited to, the use of this Userbot to send spam, harass others, or engage in any other form of unlawful or malicious activity. The developer of this Userbot does not endorse or condone any such activities, and any such use of this software is strictly prohibited. By using this Userbot, you acknowledge that you are solely responsible for your own actions and that the developer of this Userbot shall not be held liable for any damages or consequences that may arise from your use of this software. It is your responsibility to ensure that you have obtained all necessary permissions and consents before using this Userbot to interact with others, and that you respect their privacy and rights. The developer of this Userbot shall not be held liable for any breach of privacy or rights that may occur as a result of your use of this software.
Licence
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.

