"She bans. She slaps. She runs on Python. She's single."
The most unnecessarily modular Telegram bot in the wild.
Built with Python 3, backed by PostgreSQL, and overflowing with chaos.
Warning: If you fork this and it breaks, I’ll send thoughts and prayers. No tech support for your Frankenstein builds.
- Modular AF — Drop in a plugin, the bot eats it. No burps.
- PostgreSQL-backed — Because real bots don’t use flat files.
- Drag-and-drop plugins — Like Minecraft mods, but nerdier.
- Group management — Slap users, welcome new ones, filter memes.
- Admin hierarchy — Owner > Sudo > Peasant.
- Clone it like your ex’s Spotify password:
git clone https://github.com/yourusername/MissAhegaoBot.git
cd MissAhegaoBot- Install dependencies like it’s 2012:
pip3 install -r requirements.txt- Yeet your config:
Inside tg_bot/, create config.py:
from tg_bot.sample_config import Config
class Development(Config):
OWNER_ID = 123456789 # put your ID, not your crush's
API_KEY = "put-your-token-here" # you did use BotFather, right?
SQLALCHEMY_DATABASE_URI = "postgresql://user:pass@localhost:5432/db"
SUDO_USERS = [111, 222] # The chosen ones
LOAD = []
NO_LOAD = ['translation'] # Because we don't speak French- Send it:
python3 -m tg_botsudo apt install postgresql
sudo su - postgres
createuser -P -s YOUR_USER
createdb -O YOUR_USER YOUR_DB_NAMEThen your connection string looks like:
postgresql://user:password@localhost:5432/yourdbname
No spaces. No typos. No crying.
Drop .py files in modules/.
They auto-load. Like a microwave but for bot commands.
Example:
from tg_bot import dispatcher
__mod_name__ = "Anime"
__help__ = "Use /baka to feel pain."
dispatcher.add_handler(...)Also valid:
__stats__()— for/stats__migrate__()— for group ID switches (Telegram moment)
Env variable mode supports:
TOKEN,OWNER_ID,DATABASE_URL,WEBHOOK, etc.LOAD,NO_LOAD,SUDO_USERS,SUPPORT_USERS- Even
BAN_STICKER, because banning with style matters.
- Use Python 3.6+ or feel the wrath of unordered dicts.
- 8 threads is default. 9000 is excessive. Don’t be that guy.
/helpcommand auto-pulls from your module docs. Stop being lazy.
- Inspired by PaulSonOfLars
- Maintained by you. Yes, YOU. Because I won’t help.
- If it works, you’re welcome. If it doesn’t, read the logs.
Sure. Put this in your config and manifest capitalism:
DONATION_LINK=https://ko-fi.com/yourpageMIT.
Do whatever you want. Just don’t DM me asking why your fork is on fire.
Once you've installed the dependencies, you’ll need to summon the configuration ritual.
This bot uses a config.ini file instead of boring old Python configs. Here’s how to feed her soul:
[ahegaoconfig]
TOKEN = 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 ; from @BotFather
OWNER_ID = 123456789 ; your Telegram ID
OWNER_USERNAME = yourusername ; no @, just vibes
SQLALCHEMY_DATABASE_URI = postgresql://user:pass@localhost:5432/db
DB_NAME = missabot_db
MESSAGE_DUMP = -1001527488593
LOAD =
NO_LOAD =
WEBHOOK = False
URL =
PORT = 5000
DEV_USERS =
SUDO_USERS =
SUPPORT_USERS =
WHITELIST_USERS =
CERT_PATH =
INFOPIC = False
DEL_CMDS = True
STRICT_GBAN = True
STRICT_GMUTE = False
WORKERS = 8
BAN_STICKER = CAADAgADOwADPPEcAXkko5EB3YGYAg
ALLOW_EXCL = True
SUPPORT_CHAT = missahegaosupport
START_STICKER = CAACAgIAAx0CWFZqDQABBkpeYT4ykmRFN7qjtrzCH4-EYzGVkGwAAmIAA3_0Mxx8ZiETK_KDeiAE
LOGS =
BACKUP_PASS = 12345
IGNORE_PENDING_REQUESTS = TruePro Tip: If you're on Heroku or somewhere cloudy, these can also be set as environment variables. But let's be honest —
.iniis prettier.
Make your bot read this using configparser:
import configparser
config = configparser.ConfigParser()
config.read("config.ini")
TOKEN = config["ahegaoconfig"]["TOKEN"]
OWNER_ID = int(config["ahegaoconfig"]["OWNER_ID"])Boom. Config done. You’re basically a sysadmin now.