https://github.com/fantox/atlas-md
Most powerful and feature packed Whatsapp bot builtwith WhatsApp MD support
https://github.com/fantox/atlas-md
baileys baileys-bot baileys-md bot md-bot whatsapp whatsapp-automation whatsapp-bot
Last synced: 7 months ago
JSON representation
Most powerful and feature packed Whatsapp bot builtwith WhatsApp MD support
- Host: GitHub
- URL: https://github.com/fantox/atlas-md
- Owner: FantoX
- License: mit
- Created: 2023-08-31T17:24:27.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-05T16:49:52.000Z (over 1 year ago)
- Last Synced: 2025-03-28T16:05:22.601Z (7 months ago)
- Topics: baileys, baileys-bot, baileys-md, bot, md-bot, whatsapp, whatsapp-automation, whatsapp-bot
- Language: JavaScript
- Homepage:
- Size: 6.83 MB
- Stars: 105
- Watchers: 2
- Forks: 576
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Atlas MD
Konnichiwa Senpai, I am "Atlas" an Opensource WhatsApp bot made by FantoX and his team "Atlas" to do everything that's beyond imagination with highest Features and Stability and Compatibility built with Baileys Multi Device support.
Atlas MD - The Future Is Here
---
# π§© Deploy Atlas
Click to choose your favourite platform to Deploy
Deploy on Repl.it
__________________________
Deploy on Railway
__________________________
Deploy on Koyeb
__________________________
Deploy on Heroku
__________________________
Deploy on Mogenius
__________________________
Deploy on Uffizzi
__________________________
Deploy on BoxMineWorld
__________________________
# π Atlas Deploy and Hosting guide
Click to read Deploy Manual
## πΆ Repl.it Deploy:
- [Fork Main Repo](https://github.com/FantoX/Atlas-MD/fork)
- Create a MongoDB URL. Need help? Watch this short 1 minute [Video Guide](https://youtube.com/shorts/pIHvoXkwmq4?feature=share) for MongoDB URL.
- Click on `Deploy to Repl.it` button ( `For those who didn't modified bot.`). In other case (`For those who modified bot.`) edit README.md file and chage the repo link of Repl.it deply button from `https://github.com/Fantox01/Atlas-MD` to your fork URL `https://github.com//`.
- After cloning is done in Repl.it go to `Secrets` in your Repl.it project and put these values (Mandatory).
KEY | VALUE
-- | --
MODS | Phone numbers in this format (`918101187876`,`925897863489`) without `+` or `SPACE`.
MONGODB | Your MongoDB URL
SESSION_ID | Any random value (`EX: gwfdrte5678`) and `keep it copied`.
PREFIX | Any single special character except `@` (`Ex: . or / or * or , etc.`)
TENOR_API_KEY | Your tenor API key if you have. Or use this public one: `AIzaSyCyouca1_KKy4W_MG1xsPzuku5oa8W358c`
- Next click on `Green Play button` in Repl.it to start bot installation.
- After it's deployed an webpage should appear just put your Previously copied `Session ID` and click on `Get QR`.
- Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- After connecting come back to Repl.it and copy that Website (Webview) link from Repl.it.
- Next create a [UptimeRobot](https://uptimerobot.com/?rid=40f9e46fb079d4) account and add that copied lin kas an `HTTPS` monitor in UptimeRobot.
- UptimeRobot will prevent Repl.it's auto sleep.
- If you are having issues follow [Repl.it Deploy Tutorial](https://youtu.be/R-_DU73UH8Q).
## βοΈ Heroku Deploy:
- [Fork Main Repo](https://github.com/FantoX/Atlas-MD/fork)
- Create a MongoDB URL. Need help? Watch this short 1 minute [Video Guide](https://youtube.com/shorts/pIHvoXkwmq4?feature=share) for MongoDB URL.
- Click on `Deploy to Heroku` button ( `For those who didn't modified bot.`). In other case (`For those who modified bot.`) edit README.md file and chage the repo link of Repl.it deply button from `https://github.com/Fantox01/Atlas-MD` to your fork URL `https://github.com//` also got to `app.json` and change `Website` ans `Repository` link from my link to your link. Then click on `Deploy to Heroku` button.
- Then put these values in environment variables accordint to instructions (Mandatory).
KEY | VALUE
-- | --
MODS | Phone numbers in this format (`918101187876`,`925897863489`) without `+` or `SPACE`.
MONGODB | Your MongoDB URL
SESSION_ID | Any random value (`EX: gwfdrte5678`) and `keep it copied`.
PREFIX | Any single special character except `@` (`Ex: . or / or * or , etc.`)
TENOR_API_KEY | Your tenor API key if you have. Or use this public one: `AIzaSyCyouca1_KKy4W_MG1xsPzuku5oa8W358c`
- Next start deploy and wait for 3-4 minutes.
- After it's done click on `Manage App`.
- Next go to `Recources` then turn on `Web: npm start` and disable other one `If there is any other button.`
- After that go to More ---> view logs and wait for qr to appear.
- When you see broken QRs are appearing chick on `Open app` and put your Previously copied `Session ID` and click on `Get QR`.
- Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
## π· Railway Deploy:
- [Fork Main Repo](https://github.com/FantoX/Atlas-MD/fork)
- Create a MongoDB URL. Need help? Watch this short 1 minute [Video Guide](https://youtube.com/shorts/pIHvoXkwmq4?feature=share) for MongoDB URL.
- Click on `Deploy to Railway` button ( `For those who didn't modified bot.`). If you modified bot and want to deploy your modified version in Railway then that button will not help you. Go to Railway website and deploy github repo from there manually.
- Those who are deploying through button: Put all necessary details there according to instructions given there.
- Those who are deploying manually from Railway website put these `Enviroment Variables` before start deploying ( Mandatory).
KEY | VALUE
-- | --
MODS | Phone numbers in this format (`918101187876`,`925897863489`) without `+` or `SPACE`.
MONGODB | Your MongoDB URL
SESSION_ID | Any random value (`EX: gwfdrte5678`) and `keep it copied`.
PREFIX | Any single special character except `@` (`Ex: . or / or * or , etc.`)
TENOR_API_KEY | Your tenor API key if you have. Or use this public one: `AIzaSyCyouca1_KKy4W_MG1xsPzuku5oa8W358c`
- 5-6 minutes later when Deploy is completed click on that generated domain to go to QR page.
- just put your Previously copied `Session ID` and click on `Get QR`.
- Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- If you are having issues follow [Railway Deploy Tutorial](https://youtu.be/Qs6ryWnEtu8).
## βοΈ Koyeb Deploy:
- [Fork Main Repo](https://github.com/FantoX/Atlas-MD/fork)
- Create a MongoDB URL. Need help? Watch this short 1 minute [Video Guide](https://youtube.com/shorts/pIHvoXkwmq4?feature=share) for MongoDB URL.
- Click on `Deploy to Railway` button ( `For those who didn't modified bot.`). If you modified bot and want to deploy your modified version `I'm sorry to say as Koyeb works through Quay.io hosted docker so you can't deploy your modified version in fully 100% working state.` Though you can deploy manually your Github repo in Koyeb but in that case bot's 100% commands will not work.
- Those who are deploying through button: Put all necessary details there according to instructions given there (Don't forget to change MongoDB URL an put your URL).
- Those who are deploying manually from Koyeb website put these `Enviroment Variables` before start deploying ( Mandatory).
KEY | VALUE
-- | --
MODS | Phone numbers in this format (`918101187876`,`925897863489`) without `+` or `SPACE`.
MONGODB | Your MongoDB URL
SESSION_ID | Any random value (`EX: gwfdrte5678`) and `keep it copied`.
PREFIX | Any single special character except `@` (`Ex: . or / or * or , etc.`)
TENOR_API_KEY | Your tenor API key if you have. Or use this public one: `AIzaSyCyouca1_KKy4W_MG1xsPzuku5oa8W358c`
- 10 minutes later when Deploy is completed click on that generated weblink to go to QR page.
- just put your Previously copied `Session ID` and click on `Get QR`.
- Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- If you are having issues follow [Koyeb Deploy Tutorial](https://youtu.be/OvNnpK1Gx6Y).
## πͺ CMD / VS Code / Powershell / Terminal Deployment Method
- [Download Updated code](https://github.com/FantoX/Atlas-MD/archive/refs/heads/main.zip) from Main GitHub Repo or Download from your Forked Repo.
- Extract the `.zip` and open Vs code / Cmd / Powershell / Terminal in that directory and give thesse following commands one-by-one:
- Rename `.env.example` to `.env` and fill in the required details in `.env` file and `config.js` (Mandatory).
```
npm i
npm start
```
- To get new QR if you logged out from the WhatsApp linked device section go to `.env` file and change `SESSION_ID` to any random string and save it by clicking on `Commit Changes`.
### β§ Requirements for CMD/VS code istallation:
- [Node.js](https://nodejs.org/en/download/)
- [Git](https://github.com/git-guides/install-git)
- FFmpeg ( [for Windows](https://www.geeksforgeeks.org/how-to-install-ffmpeg-on-windows/) or [for Linux](https://www.tecmint.com/install-ffmpeg-in-linux/) or [for Mac](https://ffmpeg.org/download.html) )
- Libwebp (Not necesary for Windows).
Note: If you don't pre-install these before CMD / VS code Installation bot will not start!
---
## π§ UserLand Deployment Method (Not Recommented a bit)
#### βοΈ Download `UserLand` application old version ( 3.1.2 ) from [Here](https://m.apkpure.com/userland-linux-on-android/tech.ula/variant/3.1.2-APK).
#### βοΈ Install `Debian` terminal in userland.
#### βοΈ Rename `.env.example` to `.env` and fill in the required details in `.env` file and `config.js` (Mandatory).
### UserLand commands:
```
sudo apt update
sudo apt upgrade
sudo apt install bash
sudo apt-get install libwebp-dev
sudo apt install git
sudo apt install nodejs -y
sudo apt install ffmpeg -y
sudo apt install wget
sudo apt install npm
sudo apt install imagemagick
git clone https://github.com/FantoX/Atlas-MD
ls
cd Atlas-MD
npm i
cd
npm install --global yarn
yarn add sharp
sudo apt install curl
curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
yarn add sharp
cd Atlas-MD
npm i
npm start
```
- Note in `git clone ` section your can use Your customised bot's github link too (For that make sure you [Forked](https://github.com/FantoX/Atlas-MD/fork) this repo and modified `.env` file and `config.js`).
- This method will work on most other bots too.
#### π To stop a bot in Userland
- Tap on `CTRL` button then tap on `C` from keyboard
#### π To start bot again ( While you are inside Atlas-MD folder {use `cd Atlas-MD` to get inside the folder} )
- `npm start` or use `yarn start` to start bot again.
#### π Start bot after UserLand session is cleared
```
cd Atlas-MD
npm start
```
#### π What to do if you logged out from the WhatsApp linked device section and want to get new qr to login
- Go to your GitHub fork of this bot and open `.env` file and change `SESSION_ID` to any random string and save it by clicking on `Commit Changes`.
- Then open `UserLand` and run these commands one-by-one:
```
cd Atlas-MD
git fetch origin
git merge origin/main
npm start
```
#### βοΈ Note as UserLand is a physical server so you must keep on your internet connection active to make sure bot works. Otherwise bot will be down.
# π Install plugins
Open Plug-in Store
## πͺ Economy plug-in
**γ½οΈ Description:** This plugin conatains all Cashino and Gambling commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/63bcf78d6da0bce7d9f18343e3143fbc/raw/224c92477109f7082f698890fe510874da597d5c/economy.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/63bcf78d6da0bce7d9f18343e3143fbc)
## πͺ RPG plug-in
**γ½οΈ Description:** This plugin conatains all RPG game commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/151e440d351549c896042155c223c59c/raw/2fbced16ebd14300f917248801c707d9733118ad/rpg.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/151e440d351549c896042155c223c59c)
## πͺ Code-Runner plug-in
**γ½οΈ Description:** This plugin conatains commands made for Coders
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/8c2b76e4ed2d96eb370379a56f0cf330/raw/d3322fab57c52afd83cf83fc3f5afa493dc4e88f/code-Runner.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/8c2b76e4ed2d96eb370379a56f0cf330)
## πͺ Audio Edit plug-in
**γ½οΈ Description:** This plugin conatains 8 audio modification commands using "**ffmpeg**"
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/4e097be1a35b9c00bf0bc9f6635e335b/raw/cc57a7780dd80612b62ded960af3d70d19662956/audio-edit.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/4e097be1a35b9c00bf0bc9f6635e335b)
## πͺ Image Edit plug-in
**γ½οΈ Description:** This plugin conatains 4 image manipulation commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/9f6cb696d645a49a98abba00c570cfe9/raw/23154ec10c2ee08558a8aca44389f0a983aa4dea/image-Edit.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/9f6cb696d645a49a98abba00c570cfe9)
## πͺ Text to Speech plug-in
**γ½οΈ Description:** This plugin conatains text-to-speech functionality with 7 languages using "**google text to speech engine**"
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/998a3b2937080af7c30a2639544fa24c/raw/afc9ba94cbaea95e971e3aea3f80e492249c75d7/text-to-speech.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/998a3b2937080af7c30a2639544fa24c)
## πͺ Logo Maker plug-in
**γ½οΈ Description:** This plugin conatains 40 logo maker commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/67035f308b809aaabad8faa001fe473d/raw/72c2b3c100471375755817119c7ab391985bd7f3/logo-maker.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/67035f308b809aaabad8faa001fe473d)
## πͺ Chat GPT plug-in
**γ½οΈ Description:** This plugin conatains 2 main Open AI tools which are "**ChatGPT**" and "**Dall-E**"
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/04507d2d7411996622513759ea05775d/raw/7d27fc2bb2f6d8a45d3e929e3904c66895d811ad/chat-GPT.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/04507d2d7411996622513759ea05775d)
## πͺ Fun Commands plug-in
**γ½οΈ Description:** This plugin conatains 17 funny commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/e02ed98798e5cc73a0778d8bc04f0f03/raw/77293b2b35d875ce0c91357d879fe5d0881423b9/fun.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/e02ed98798e5cc73a0778d8bc04f0f03)
## πͺ Tiktok Downloader plug-in
**γ½οΈ Description:** This plugin conatains 4 tiktok video downloader commands.
**π§²οΈ Plug-in installation url:**
```
https://gist.githubusercontent.com/FantoX/2de67bc72021805417cbd317385ea71a/raw/f70879fc861dadd440f4a4a7dbb01cdae44b3c56/tiktokdl.js
```
π‘ [Plug-in Source Code β](https://gist.github.com/FantoX/2de67bc72021805417cbd317385ea71a)
## πͺ Anime NSFW Image plug-in
**γ½οΈ Description:** This plugin conatains 100 anime NSFW image commands using my own API
**π§²οΈ Plug-in will be back soon...**
Join my WhatsApp Group for Discussion / Suggestion / Help.
---
# β‘οΈ Atlas Platform Compatibility:
- Atlas offers highest platform compatibility.
- Just deploy and use on your favourite platform.
- Sorted by Recommendation: Repl.it, Railway, Heroku, Koyeb
# π« Dependencies of Atlas:
- [WhiskeySockets Baileys V-6.1.0](https://github.com/WhiskeySockets/Baileys)
- [Scrappy API (For Instagram, Facebook, Lyrics and βvideos scraping )](https://github.com/FantoX/Scrappy-API)
- [FantoX APIs ( For NSFW )](https://fantox-api.vercel.app/)
---
# π Key Features:
Read More
- Read [PublicKeys.md](https://github.com/FantoX/Atlas-MD/blob/main/PublicKeys.md) to use our `provided public keys` if you are lazy to create your own. We have already provided everying you need to run the bot.
- Changeable between `20 added Characters` ( Atlas, Power, Makima, Denji, Zero Two, Chika, Miku, Marin Kitagawa ) and more can be added by user inside `BotCharacters.js` file. Type `-charlist` command to get character list.
- Fully powered by MongoDb ( 3 databases added ).
- Self / Public / Private mode.
- Single prefix ( "-" ).
- RPG and Economy added ( More coming soon ).
- Group Chatbot / Dm Chatbot ( Only reply on quoted messages and and be turned off ).
- 100+ NSFW commands ( Using my own API ). Visit: [My API Page](https://fantox-api.vercel.app) for more info.
- Highest Commands and Features.
- User Banning / Group Banning.
- Highest Security compared to most other public bots.
# γ½οΈ Why Should You Use Atlas as your Base:
Read More
- Atlas is a `fully open source` bot which means `no copyright`.
- Atlas is a `multi character bot` which means you can `change bot's character` to any of the 8 added characters or add more characters by yourself.
- Atlas is a `multi database bot` which means you can use 3 different databases at the same time.
- Atlas is a `multi mode` bot which means you can use it in `Self / Public / Private` mode.
- Atlas has a pre installed chatbot which means you can use it as a `group chatbot and dm chatbot`.
- Atlas has `Highest NSFW (100+)` which means you can use it as a `nsfw bot`.
- Atlas has 300+ commands.
- Atlas doesn't store your `Session File` locally which means it's `safe` and `secure`.
- Atlas has `RPG and Economy` which means you can use it as a `RPG Bot` or `Casino Bot`.
- Atlas has `User Banning / Group Banning` which means you can use it as a `Anti Spam Bot`.
- Atlas is a Folder Type bot which represents `Highest Stability`, `Highest Performance` and `Developer / User friendly`.
- Atlas comes with [MIT](https://github.com/FantoX/Atlas-MD/blob/main/LICENSE.md) License which means you can use it as a `base for your own bot` and can `modify it as you want` and can `add your own features`.
# π§£ Contributors:
- Check [Atlas Contributors](https://github.com/FantoX/Atlas-MD/graphs/contributors) list.
- Feel free to contribute in this project it increase it's stability and update. I will merge your respected contribution after reviewing it.
- No personal modification / re-branding ( Changing bot name, owner name ) pull requests will be merged !
# β οΈ Warning:
- This bot is not made by WhatsApp.inc so overusing this bot may result in WhatsApp account ban.
- We will only assist you in `Bot Deployment ( Installation or Hosting )`. Not in `Bot Development`.
- If you Modify this bot and face any issues, I am not responsible for that because it's not possible for me or my team to help everyone in bot Development / Modification. Only modify if you know what you are doing.
- This bot is made for `Educational / Fun / Group Management` purposes only. I and the team will not be responsible for any misuse of this bot.
- We will only assist you in `Setup / Deployment` of this bot.
# π Legal Disclaimer
- We suggest you to use your `Own MongoDB URL` while deploying inside `.env` or `Environment Variables`. That will increase your Privacy and Security.
- We don't recommend to hardly modify the script. `If you do so, you will be responsible for any issues / bugs and we will not provide any support` as we are also busy in our life.
- We will not be responsible for any issues caused by any individual hosting this bot and cause any harm to any Group `(So don't make someone Group Admin who you don't know just because they are hosting the Bot)`.
---
π° Meet Team Atlas π°
[](https://github.com/FantoX) | [](https://github.com/Ahmii-kun) | [](https://github.com/pratyush4932) | [](https://github.com/Devime69) | [](https://github.com/Kai0071) | [](https://github.com/jayjay-ops)
----|----|----|----|----|----
[FantoX](https://github.com/FantoX) | [Ahmii Kun](https://github.com/Ahmii-kun) | [Pratyush](https://github.com/pratyush4932) | [Devime](https://github.com/Devime69) | [Kai](https://github.com/Kai0071) | [Jayjay Ops](https://github.com/jayjay-ops)
Owner, Main Developer, Maintainer, Dubugger | Co-Developer, Co-Maintainer | Support Developer | API Maintainer | Ideas, Testing | Ideas, Testing