Repolode
nonebot

nonebot/nonebot2

Framework asíncrono de Python para crear chatbots que se conectan a varias plataformas de chat mediante adaptadores de protocolo intercambiables.

Estrellas
7,779
Forks
659
Issues abiertos
51
Último commit
hace 16 horas

¿Qué es?

NoneBot2 es un framework de Python para crear chatbots. Gestiona los eventos entrantes y los envía a tus handlers, mientras que los adaptadores de protocolo se encargan de comunicarse con cada plataforma de chat. El framework no implementa ninguna plataforma; depende de adaptadores para OneBot, Telegram, Feishu, Discord, GitHub, QQ y otras, y los adaptadores de la comunidad amplían aún más la lista.

El framework se basa en las anotaciones de tipos de Python y en la E/S asíncrona, por lo que un solo proceso puede gestionar un gran volumen de mensajes de forma concurrente. Su capa de drivers permite ejecutarlo sobre frameworks web como FastAPI o Quart, o usar aiohttp, httpx o websockets como clientes; puedes intercambiarlos o combinarlos según lo necesites.

El proyecto incluye nb-cli, una herramienta para crear la estructura inicial y ejecutar proyectos, y admite un ecosistema de plugins que añade funcionalidades al núcleo.

Funciones clave

  • 01Gestión asíncrona de mensajes basada en la E/S asíncrona de Python.
  • 02Adaptadores de protocolo para OneBot, Telegram, Feishu, Discord, QQ y más.
  • 03Anotaciones de tipos completas que permiten la verificación de tipos en el editor.
  • 04Drivers intercambiables para FastAPI, Quart, aiohttp, httpx y websockets.
  • 05Herramienta nb-cli para crear, ejecutar y gestionar proyectos.
  • 06Sistema de plugins para añadir funcionalidades al núcleo.

Casos de uso

  • Crear un bot de grupo para QQ o basado en OneBot con comandos personalizados.
  • Crear un bot de Telegram o Discord que responda a eventos del chat.
  • Integrar un bot con los webhooks y eventos de Feishu o GitHub.
  • Crear un servicio de automatización controlado por chat que funcione en varias plataformas desde una misma base de código.

Inicio rápido

  1. 1

    Lee la guía oficial de inicio rápido enlazada en el README

Antes de usarlo

  • Algunos adaptadores para plataformas de chat no están disponibles o los mantiene la comunidad, como DingTalk, que está buscando a alguien que se encargue de su mantenimiento.
  • La compatibilidad de los adaptadores varía según la plataforma, y la interfaz oficial de QQ cambia con frecuencia.

En colecciones

Temas

Preguntas frecuentes

¿Qué es nonebot2?
Framework asíncrono de Python para crear chatbots que se conectan a varias plataformas de chat mediante adaptadores de protocolo intercambiables. NoneBot2 es un framework de Python para crear chatbots. Gestiona los eventos entrantes y los envía a tus handlers, mientras que los adaptadores de protocolo se encargan de comunicarse con cada plataforma de chat. El framework no implementa ninguna plataforma; depende de adaptadores para OneBot, Telegram, Feishu, Discord, GitHub, QQ y otras, y los adaptadores de la comunidad amplían aún más la lista.
¿nonebot2 es gratuito? ¿Qué licencia tiene?
nonebot2 es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿nonebot2 sigue mantenido?
Mantenimiento activo. El último commit de nonebot2 fue el 6 nov 2026.
¿Para qué puedo usar nonebot2?
Crear un bot de grupo para QQ o basado en OneBot con comandos personalizados. Crear un bot de Telegram o Discord que responda a eventos del chat. Integrar un bot con los webhooks y eventos de Feishu o GitHub. Crear un servicio de automatización controlado por chat que funcione en varias plataformas desde una misma base de código.
¿Cómo se instala nonebot2?
Lee la guía oficial de inicio rápido enlazada en el README
¿Dónde consigo nonebot2?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/nonebot/nonebot2

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados