qq-botpy
qq robot client with python3
Decision gist · record as of 2026-08-14
Yes, if you are building a QQ bot and accept dormant maintenance. The framework is stable with no known vulnerabilities and low install friction. However, expect no active support or updates—verify that the current API surface matches your QQ Open Platform version before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.7+.
- Needs valid QQ Open Platform credentials (appid and token) to connect.
- Low friction install via wheel distribution.
License · maintenance · safety
Tencent (permissive) — Licensed under a permissive Tencent license (not SPDX-identified), which typically permits use and modification without restriction; verify the exact terms in the repository if redistribution or commercial use is planned.
last release 2024-03-22 (875 days) · last repo commit 2024-09-14 · 902 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 259,392 downloads/mo, #8,412 on PyPI
Alternatives
Verify before relying
pip install qq-botpy
import botpy
from botpy.types.message import Message
class MyClient(botpy.Client):
async def on_at_message_create(self, message: Message):
await message.reply(content="Hello")
intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid="YOUR_APPID", token="YOUR_TOKEN")- Whether the dormant maintenance status affects stability or compatibility with current QQ Open Platform API versions.
- Specific Python version support ceiling (requires_python is unspecified in metadata).
- Whether aiohttp, PyYAML, and APScheduler versions are pinned or have known compatibility constraints.
What it is and what it does
qq-botpy is an async Python framework for building bots on Tencent's QQ Open Platform. It wraps the platform's REST API and event streaming, letting you define a bot by subclassing `botpy.Client` and implementing event handlers like `on_at_message_create` for @-mentions or `on_ready` for startup. The framework manages connection lifecycle, intent subscription, and async message dispatch via aiohttp, with APScheduler available for scheduled tasks and PyYAML for config loading.
You register which event types to listen for via an `Intents` object, then call `client.run()` with your app credentials. The framework handles incoming events as typed objects (e.g., `Message`), and you reply or post via `self.api` methods. It's designed for guild-based chat bots and direct messages, with built-in support for rich message types (embeds, markdown, keyboards, file attachments).
Use it for
- Build a QQ guild bot that responds to @-mentions with automated replies or command processing.
- Create a scheduled announcement bot using APScheduler to post messages at fixed times.
- Implement a moderation or logging bot that listens to guild member events and message changes.
- Develop a bot that fetches external data and posts formatted embeds or markdown messages to QQ channels.
- Set up a bot that handles direct messages and routes them to a backend service.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a QQ bot and accept dormant maintenance.
The framework is stable with no known vulnerabilities and low install friction. However, expect no active support or updates—verify that the current API surface matches your QQ Open Platform version before committing to production use.
Install
qq-botpy on PyPI
Before you install
Low friction install via wheel distribution. Maintenance is dormant—last release was 2024-03-22 and no commits since 2024-09-14—so expect no active bug fixes or feature updates, though the codebase remains available.
Requires Python 3.7+. Needs valid QQ Open Platform credentials (appid and token) to connect.
License in practice
Licensed under a permissive Tencent license (not SPDX-identified), which typically permits use and modification without restriction; verify the exact terms in the repository if redistribution or commercial use is planned.
Quickstart
pip install qq-botpy
import botpy
from botpy.types.message import Message
class MyClient(botpy.Client):
async def on_at_message_create(self, message: Message):
await message.reply(content="Hello")
intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid="YOUR_APPID", token="YOUR_TOKEN")Verify before relying
- Whether the dormant maintenance status affects stability or compatibility with current QQ Open Platform API versions.
- Specific Python version support ceiling (requires_python is unspecified in metadata).
- Whether aiohttp, PyYAML, and APScheduler versions are pinned or have known compatibility constraints.
Package facts
| License | Tencent permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesaiohttpPyYAMLAPScheduler |
| Maintenance | Dormant 875 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 259,392 / month, #8,412 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3.7Topic :: Software Development |
Evidence: qq_botpy-1.2.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “qq bot framework python”
- qq-botpyA Python framework for building QQ chat bots that connect to…
- nonebot2NoneBot2 is an asynchronous Python framework for building chatbots…
- botframework-streamingProvides streaming protocol support for Microsoft Bot Framework bots,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also nonebot2 · discord · discord.py · botframework-connector · py-cord · pybacklogpy · python-telegram-bot · twitchAPI · pyTelegramBotAPI · wechatpy