Developing KOOK bots with Python made easy

• Simple & easy-to-maintain project structure. While you still get your working hello world function in 4 lines, scaling up is much easier.

def init(_bot: Bot):
    @_bot.command(name="hello")
    async def hello_world(msg, *args):
        await msg.reply("... world!")

• Lots of examples to help you get started, including a wide range of applications from LLMs to music streaming and from file serving to currency systems.
• Easy to use and maintain. The framework is designed to be easy to use and maintain. You can never get lost in your codebase.

Python 3.9 or higher is required to run this framework. The project is developed and tested on Python 3.9.2, but it should work on any Python 3.9+ version.

Run the following command to install the required packages:

pip install -r requirements.txt

On Linux, simply run:

KOOKBOT_WS_TOKEN='<REPLACE_WITH_YOUR_BOT_TOKEN>' python3 main.py

On Windows, run:

$env:KOOKBOT_WS_TOKEN='<REPLACE_WITH_YOUR_BOT_TOKEN>'; python main.py

If you see a success message, congratulations! You have successfully set up your bot. Now send some message to a shared channel with your bot to see it in action.

Set KOOKBOTX_DEBUG=1 to see debug messages logged to the log file (default: logs/kookbotx.log).

Database integration is planned in future updates.

We welcome contributions from the community, whether it's some improvements to code structure, a utility module, or more examples. Please read the contributing guide to get started.