nonebot2
An asynchronous python bot framework.
Decision gist · record as of 2026-08-14
Yes. NoneBot2 is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and offers a genuine multi-platform abstraction for bot development. Install it if you need to build bots for multiple messaging platforms or want async-first Python bot development with strong type safety. The main constraint is Python 3.10 or later requirement.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; asyncio event loop must be running to execute bot handlers.
- Low friction installation with a pure-Python wheel.
- Active maintenance with recent commits and a stable release cycle; last commit 2026-08-14 and latest release 2026-04-01.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, making it suitable for both open-source and proprietary bot projects.
last release 2026-04-01 (135 days) · last repo commit 2026-08-14 · 7,664 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 103,293 downloads/mo, #12,816 on PyPI
Alternatives
Verify before relying
pip install nonebot2
from nonebot import on_message
from nonebot.adapters import Message
@on_message()
async def handle(msg: Message):
pass- Whether type annotation coverage is verified by static analysis tooling
- Performance characteristics under high message throughput
- Whether community-contributed adapters receive the same maintenance as official ones
- Specific platforms and protocols supported beyond those listed in the description excerpt
What it is and what it does
NoneBot2 is a modern asynchronous Python chatbot framework designed to run bots across multiple messaging platforms—QQ, Telegram, Discord, Feishu, GitHub, and others—through a unified adapter architecture. It uses Python's async/await syntax and type annotations to let developers write bot logic once and deploy it to different platforms by swapping protocol adapters. The framework handles message routing, event dispatch, and lifecycle management, while developers focus on writing command handlers and business logic.
The framework depends on nine runtime libraries including pydantic for configuration validation, loguru for logging, anyio for async compatibility, and yarl for URL handling. It ships as a pure-Python wheel with low installation friction. The project is actively maintained with a large community and production-stable status. It supports multiple web frameworks (FastAPI, Quart, aiohttp, httpx, websockets) as underlying drivers, allowing customization of the transport layer.
Use it for
- Build a QQ bot that responds to commands and forwards messages using OneBot protocol
- Create a Telegram bot with the same codebase and deploy it to Discord by switching adapters
- Develop a GitHub bot that reacts to pull requests and issues using the GitHub adapter
- Run a bot on Feishu or DoDo platforms without rewriting core logic for each platform
- Prototype a chatbot locally using the Console adapter, then deploy to production with a real messaging platform
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
NoneBot2 is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and offers a genuine multi-platform abstraction for bot development. Install it if you need to build bots for multiple messaging platforms or want async-first Python bot development with strong type safety. The main constraint is Python 3.10 or later requirement.
Install
nonebot2 on PyPI
Before you install
Low friction installation with a pure-Python wheel. Active maintenance with recent commits and a stable release cycle; last commit 2026-08-14 and latest release 2026-04-01. Requires Python 3.10 or later.
Requires Python 3.10 or later; asyncio event loop must be running to execute bot handlers.
License in practice
MIT license permits commercial and private use with minimal restrictions, making it suitable for both open-source and proprietary bot projects.
Quickstart
pip install nonebot2
from nonebot import on_message
from nonebot.adapters import Message
@on_message()
async def handle(msg: Message):
passVerify before relying
- Whether type annotation coverage is verified by static analysis tooling
- Performance characteristics under high message throughput
- Whether community-contributed adapters receive the same maintenance as official ones
- Specific platforms and protocols supported beyond those listed in the description excerpt
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 9 packagesyarlanyiologurupygtrieexceptiongrouppython-dotenvtyping-extensionstomlipydantic |
| Maintenance | Actively maintained 135 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 103,293 / month, #12,816 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: Robot FrameworkFramework :: Robot Framework :: LibraryOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: nonebot2-2.5.0-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 › “multi-platform chatbot”
- nonebot2NoneBot2 is an asynchronous Python framework for building chatbots…
- flet-cliFlet CLI is a command-line tool for creating, running, and packaging…
- late-sdkOfficial Python SDK for publishing social media posts across 16…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
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.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
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.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also qq-botpy · aiogram · python-telegram-bot · pyTelegramBotAPI · Telethon · pyrofork · Pyrogram · Kurigram · none · telebot