github.com/sharkbound/pythontwitchbotframework ↗

About sharkbound/pythontwitchbotframework

Python Twitch Bot Framework is a fully asynchronous Twitch bot library designed for Python 3.6 and higher. It provides a complete framework for building Twitch chat bots with built-in command systems using decorators, event handling, permission management, and moderation features. The framework includes features like message timers, quotes, custom commands, and a built-in economy system.

The bot supports extensive customization through a decorator-based command system with support for subcommands, command aliases, and help documentation. It includes a comprehensive permission system that allows individual channel-level permission groups with role-based access control, and permissions can be managed either through chat commands or by editing JSON configuration files. The framework also provides optional database support through SQLAlchemy, enabling integration with MySQL, PostgreSQL, and SQLite databases.

Additional features include a command whitelist system for restricting available commands, a command server for remote interaction via a console interface, Twitch PubSub client support for handling channel events like channel points and subscriptions, and a modular system for loading custom commands and extensions. The project is available on PyPI for easy installation and maintains documentation through a GitHub wiki. The bot can be configured through JSON files and includes built-in shutdown commands with proper task cleanup.