Skip to content

Latest commit

 

History

History
632 lines (445 loc) · 24.3 KB

README.md

File metadata and controls

632 lines (445 loc) · 24.3 KB
Raw

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 Heroku
Watch tutorial on YouTube


__________________________

Deploy on Railway

Deploy on Railway
Watch tutorial on YouTube


__________________________


Deploy on Koyeb

Deploy on Koyeb
Watch tutorial on YouTube


__________________________


Deploy on Heroku

Deploy on Heroku


__________________________


Deploy on Mogenius

Deploy on Mogenius


__________________________


Deploy on Uffizzi

Deploy on Uffizzi


__________________________


Deploy on BoxMineWorld

Deploy on Boxmineworld


__________________________


📑 Atlas Deploy and Hosting guide

Click to read Deploy Manual

🔶 Repl.it Deploy:

  • Fork Main Repo
  • Create a MongoDB URL. Need help? Watch this short 1 minute Video Guide 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/<Your GitHub Username>/<Your Atlas fork repo name>.
  • 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 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.



⚛️ Heroku Deploy:

  • Fork Main Repo
  • Create a MongoDB URL. Need help? Watch this short 1 minute Video Guide 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/<Your GitHub Username>/<Your Atlas fork repo name> 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
  • Create a MongoDB URL. Need help? Watch this short 1 minute Video Guide 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.



❇️ Koyeb Deploy:

  • Fork Main Repo
  • Create a MongoDB URL. Need help? Watch this short 1 minute Video Guide 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.



🪟 CMD / VS Code / Powershell / Terminal Deployment Method

  • Download Updated code 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:

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.

⚜️ 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/FantoX001/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 <my bot's repo> section your can use Your customised bot's github link too (For that make sure you Forked 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

🪟 Audio Edit plug-in

〽️ Description: This plugin conatains 8 audio modification commands using "ffmpeg"

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/b818960e024c541e155f948db34a2da2/raw/f6771fbd4c615a64eafb92d53e7627276f20167a/audio-edit.js

💡 Plug-in Source Code ↗

🪟 Image Edit plug-in

〽️ Description: This plugin conatains 4 image manipulation commands.

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/b48fd5040b2cd83e5e331c0d2c974871/raw/909c5a6a32cfcb2dbb965f1ee2a5e3025802de5b/image-edit.js

💡 Plug-in Source Code ↗

🪟 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/FantoX001/109e3f04e70ca2edeb8d47072bbd0499/raw/84de4d44994fcb8b9f315a2be41eac062378df01/text-to-speech.js

💡 Plug-in Source Code ↗

🪟 Logo Maker plug-in

〽️ Description: This plugin conatains 40 logo maker commands.

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/b8e4a9782623c6197c10f68aa798a548/raw/7466871764434cf4c2ee30b15aac871e5db48a74/logo-maker.js

💡 Plug-in Source Code ↗

🪟 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/FantoX001/ec3e327c9711b1d3059cc26b8b7945be/raw/9396030969cbf0f24ad1c318a9035540ce4577b2/chat-GPT.js

💡 Plug-in Source Code ↗

🪟 Fun Commands plug-in

〽️ Description: This plugin conatains 17 funny commands.

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/e4df3eb3cc06baaccce3130a29262b30/raw/4c9b280fe527891f4d935b36b1c06e7f2fda9f6f/fun.js

💡 Plug-in Source Code ↗

🪟 Tiktok Downloader plug-in

〽️ Description: This plugin conatains 4 tiktok video downloader commands.

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/481b039ef502a56339374b29b7491695/raw/854ed660349cc3fd45de89ce137721c674a03ec3/tiktokdl.js

💡 Plug-in Source Code ↗

🪟 Anime NSFW Image plug-in

〽️ Description: This plugin conatains 100 anime NSFW image commands using my own API

🧲️ Plug-in installation url:

https://gist.githubusercontent.com/FantoX001/804c106f1f2fb1ae46e9bd63f854069d/raw/a93191b83c0cca44abb7e0e26b55caf2892f0bb4/nsfw-image.js





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:



🎀 Key Features:

Read More
  • Read 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 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 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 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 🔰

Fantox Ahmii-kun Pratyush Devime Kai JayJay Ops
FantoX Ahmii Kun Pratyush Devime Kai Jayjay Ops
Owner, Main Developer, Maintainer, Dubugger Co-Developer, Co-Maintainer Support Developer API Maintainer Ideas, Testing Ideas, Testing