Konnichiwa Senpai, I am "faaceless" an Opensource WhatsApp bot made by kiddagoat Kiddagoat and his team "Faaceless" to do everything that's beyond imagination with highest Features and Stability and Compatibility built with Baileys Multi Device support.
Click to choose your favourite platform to Deploy
__________________________
__________________________
__________________________
__________________________
__________________________
__________________________
__________________________
Click to read Deploy Manual
- 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 fromhttps://github.com/kiddagoat1/faaceless
to your fork URLhttps://github.com/<Your GitHub Username>/<Your Faaceless 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 (2348100145944 ,2348183329983 ) 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 onGet 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.
- 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 fromhttps://github.com/kiddagoat1/faaceless
to your fork URLhttps://github.com/<Your GitHub Username>/<Your faaceless fork repo name>
also got toapp.json
and changeWebsite
ansRepository
link from my link to your link. Then click onDeploy to Heroku
button. - Then put these values in environment variables accordint to instructions (Mandatory).
KEY | VALUE |
---|---|
MODS | Phone numbers in this format (2348100145944 ,2348183329983 ) 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 onWeb: npm start
and disable other oneIf 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 copiedSession ID
and click onGet QR
. - Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- 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 (2348183329983 ,2348100145944 ) 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 onGet QR
. - Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- If you are having issues follow Railway Deploy Tutorial.
- 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 versionI'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 (2348183329983 ,2348100145944 ) 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 onGet QR
. - Scan the QR from WhatsApp ---> Linked devices ---> Link a device.
- If you are having issues follow Koyeb Deploy Tutorial.
- 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 andconfig.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 changeSESSION_ID
to any random string and save it by clicking onCommit Changes
.
- Node.js
- Git
- FFmpeg ( for Windows or for Linux or for Mac )
- Libwebp (Not necesary for Windows).
Note: If you don't pre-install these before CMD / VS code Installation bot will not start!
βοΈ Download UserLand
application old version ( 3.1.2 ) from Here.
βοΈ Rename .env.example
to .env
and fill in the required details in .env
file and config.js
(Mandatory).
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 Faaceless
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 Faaceless
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 andconfig.js
). - This method will work on most other bots too.
- Tap on
CTRL
button then tap onC
from keyboard
π To start bot again ( While you are inside Faaceless folder {use cd Faaceless-MD
to get inside the folder} )
npm start
or useyarn start
to start bot again.
cd Faaceless
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 changeSESSION_ID
to any random string and save it by clicking onCommit Changes
. - Then open
UserLand
and run these commands one-by-one:
cd Faaceless
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.
-Faaceless offers highest platform compatibility.
- Just deploy and use on your favourite platform.
- Sorted by Recommendation: Repl.it, Railway, Heroku, Koyeb
- Baileys Library
- Scrappy API (For Instagram, Lyrics and βvideos scraping )
- FantoX APIs ( For NSFW )
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 insideBotCharacters.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.
Read More
- Faaceless is a
fully open source
bot which meansno copyright
. - Faaceless is a
multi character bot
which means you canchange bot's character
to any of the 8 added characters or add more characters by yourself. - Faaceless is a
multi database bot
which means you can use 3 different databases at the same time. - Faaceless is a
multi mode
bot which means you can use it inSelf / Public / Private
mode. - Faaceless has a pre installed chatbot which means you can use it as a
group chatbot and dm chatbot
. - Faaceless has
Highest NSFW (100+)
which means you can use it as ansfw bot
. - Faaceless has 300+ commands.
- Faaceless doesn't store your
Session File
locally which means it'ssafe
andsecure
. - Faaceless has
RPG and Economy
which means you can use it as aRPG Bot
orCasino Bot
. - Faaceless has
User Banning / Group Banning
which means you can use it as aAnti Spam Bot
. - Faaceless is a Folder Type bot which represents
Highest Stability
,Highest Performance
andDeveloper / User friendly
. - Faaceless comes with MIT License which means you can use it as a
base for your own bot
and canmodify it as you want
and canadd your own features
.
- Check Faaceless Contributors list.
- Feel free to contribute in this project. I will merge your respected contribution after reviewing it.
- 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 inBot 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.
- We suggest you to use your
Own MongoDB URL
while deploying inside.env
orEnvironment Variables
. That will increase your Privacy and Security. - We don't recommend to change the
Economy database
we have added inside script.If you do so, you will be responsible for any issues and we will not provide any support
. - 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)
.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
---|---|---|---|---|---|---|
FantoX | Ahmii Kun | Pratyush | Devime | Kai | Jayjay Ops | kiddagoat |
Owner, Main Developer, Maintainer, Dubugger | Co-Developer, Co-Maintainer | Support Developer, Modules | Designing, API Maintainer | Ideas, Testing, Re-Checking | Ideas, Testing, Re-Checking | Creator of Faaceless |