Creating a module has been simplified as much as possible - but do not hesitate to suggest further simplification.
All that is needed is that your .py file is in the modules folder.
To add commands, make sure to import the dispatcher via
from AmeliaRobot import dispatcher.
You can then add commands using the usual
dispatcher.add_handler().
Assigning the help variable to a string describing this modules' available commands will allow the bot to load it and add the documentation for your module to the /help command. Setting the mod_name variable will also allow you to use a nicer, user-friendly name for a module.
The migrate() function is used for migrating chats - when a chat is upgraded to a supergroup, the ID changes, so it is necessary to migrate it in the DB.
The stats() function is for retrieving module statistics, eg number of users, number of chats. This is accessed through the /stats command, which is only available to the bot owner.
Once you've set up your database and your configuration is complete, simply run the bat file(if on windows) or run (Linux):
python3 -m Amelia
You can use nssm to install the bot as service on windows and set it to restart on /gitpull Make sure to edit the start and restart bats to your needs. Note: the restart bat requires that User account control be disabled.
For queries or any issues regarding the bot please open an issue ticket or visit us at
For starters click on this button