qqbot

qqbot is a Python-based chatbot framework built on top of Tencent's SmartQQ protocol, which allowed automated interaction with the QQ messaging platform. The README notes prominently that SmartQQ was shut down on January 3, 2019, and as a result this project no longer works and is no longer maintained.

When it was functional, qqbot let you log in to a QQ account by scanning a QR code and then automate messaging tasks: monitoring incoming messages, sending messages to friends or groups, and building custom response logic through a plugin system. The bot ran on Linux, Windows, and macOS.

Custom bot behavior was added by writing a Python file with a function named onQQMessage. This function received each incoming message along with the sender's details and a bot object, and you could call bot.SendTo() to reply. Plugins could be loaded and unloaded at runtime without restarting the bot.

A companion command-line tool called qq let you control the running bot: listing contacts, searching within friend or group lists, sending messages, and loading or unloading plugins. All commands also had corresponding HTTP API endpoints, making it possible for web applications to trigger actions by calling local URLs.

Because the underlying SmartQQ service no longer exists, this repository serves only as a historical reference. Anyone looking for a working QQ bot framework would need to find a project based on a currently supported protocol.