Available On Telegram As
Collect Em all and
Ask for Help in our Support Chat
● This is an Open Source Implementation of Character Catcher Bot for Telegram.
● For Example, Grab/Hunt/Protecc/Collect etc.. These Types of Bot you must have seen it on your telegram groups..
● This bot sends characters in group after every 100 Messages Of Groups. Then any user can guess that character's Name using /guess Command.
We used Python-Telegram-Bot v20.6 and a little bit of Pyrogram.
Use rarity number accordingly:
| Number | Rarity |
|---|---|
| 1 | ⚪️ Common |
| 2 | 🟣 Rare |
| 3 | 🟡 Legendary |
| 4 | 🟢 Medium |
/guess- Guess the character/fav- Add a character to favorites/trade- Trade a character with another user/gift- Gift a character to another user/collection- Boast your harem collection/topgroups- List the groups with biggest harem (globally)/top- List the users with biggest harem (globally)/ctop- List the users with biggest harem (current chat)/changetime- Change the frequency of character spawn
/upload- Add a new character to the database/delete- Delete a character from the database/update- Update stats of a character in the database
/ping- Pings the bot and sends a response/stats- Lists number of groups and users/list- Sends a document with list of all users that used the bot/groups- Sends a document with list of all groups that the bot has been in
- Click the button below to deploy directly on Heroku:
- After deployment, open your Heroku app → Settings → Config Vars and add the following:
| Variable Name | Example Value | Description |
|---|---|---|
BOT_TOKEN |
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
Bot token from BotFather |
API_ID |
1234567 |
Telegram API ID (from my.telegram.org) |
API_HASH |
abcdef1234567890abcdef1234567890 |
Telegram API hash |
GROUP_ID |
-1001234567890 |
Numeric group ID where bot works |
DATABASE_URL |
postgres://... |
Postgres DB URL (Heroku Postgres addon) |
- Scale your worker:
heroku ps:scale worker=1
### Local Deploy/VPS
- Fill variables in [`config.py`](./shivu/config.py)
- Open your VPS terminal (we're using Debian based) and run the following:
```bash
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install python3-pip -y
sudo pip3 install -U pip
git clone https://github.com/<YourUsername>/WAIFU-HUSBANDO-CATCHER && cd WAIFU-HUSBANDO-CATCHER
pip3 install -U -r requirements.txt
sudo apt install tmux && tmux
python3 -m shivuThe Source is licensed under MIT, and hence comes with no Warranty whatsoever.
If you appreciate this Code, make sure to star ✨ the repository.
- Don't Use heroku. Deploy on Heroku is just for testing. Otherwise Bot's Inline will Work Too Slow.
- Use a reliable VPS provider