finds.dev

nonebot/nonebot2

跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python

View on GitHubHomepage ↗

★ 7,582PythonMITupdated Jun 2026

// the take

NoneBot2 is a Python async chatbot framework that abstracts over a dozen chat platforms — QQ, Telegram, Discord, Feishu, GitHub, and more — behind a unified plugin/matcher API. It targets developers who want to write one bot codebase and deploy it across multiple platforms without rewriting protocol logic for each. The primary audience is Chinese developers building QQ bots, though the platform coverage is genuinely broad.

100% type annotation coverage with Pyright checks in CI is real — you actually get autocomplete and type errors in editors, which most bot frameworks skip. The dependency injection system for handler parameters (event, bot, state, custom deps) mirrors FastAPI's pattern and makes handlers easy to test in isolation. The adapter model is clean enough that community adapters for obscure platforms (Matrix, VoceChat, Bilibili live) exist and work without forking core. The nb-cli scaffolding and plugin store lower the barrier for non-framework contributors to ship installable plugins.

The ecosystem is heavily QQ/Chinese-platform-centric; if you're building for Telegram or Discord specifically, you'll find the adapters lag behind native libraries like python-telegram-bot or discord.py in feature completeness and documentation. The multi-driver setup (you compose server + client drivers) is flexible but genuinely confusing to configure — the docs assume you already understand why you'd need both FastAPI and httpx at once. State management across conversations requires external storage you provision yourself; there's no built-in session persistence, so anything stateful hits you fast. Plugin load order and namespace isolation can bite you in larger projects — the plugin manager relies on Python import mechanics in ways that cause subtle conflicts when two plugins touch the same module path.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
7,582
Forks
663
Language
Python
License
MIT
Last commit
24 Jun 2026

// nearby

If nonebot2 isn't quite it.

All repos →