Repolode
Enviar
nonebot

nonebot/nonebot2

Um framework assíncrono em Python para criar chatbots que se conectam a várias plataformas de conversa por meio de adaptadores de protocolo plugáveis.

Ver no GitHubSite
Estrelas
7,783
Forks
662
Issues abertas
51
Último commit
anteontem

O que é?

NoneBot2 é um framework em Python para criar chatbots. Ele recebe eventos e os encaminha para seus handlers, enquanto os adaptadores de protocolo cuidam da comunicação com cada plataforma de conversa. O framework não implementa nenhuma plataforma por conta própria: ele depende de adaptadores para OneBot, Telegram, Feishu, Discord, GitHub, QQ e várias outras, e adaptadores da comunidade ampliam ainda mais essa lista.

O framework é baseado em anotações de tipo do Python e I/O assíncrono, permitindo que um único processo lide com um grande volume de mensagens simultaneamente. A camada de driver permite executar o framework em frameworks web como FastAPI ou Quart, ou usar aiohttp, httpx ou websockets como clientes. Você pode substituir ou combinar essas opções conforme necessário.

O projeto inclui a ferramenta de scaffolding nb-cli para criar e executar projetos e oferece suporte a um ecossistema de plugins que adiciona funcionalidades ao núcleo.

Recursos principais

  • 01Processamento assíncrono de mensagens baseado em I/O assíncrono do Python.
  • 02Adaptadores de protocolo para OneBot, Telegram, Feishu, Discord, QQ e outras plataformas.
  • 03Anotações de tipo completas, compatíveis com a verificação de tipos no editor.
  • 04Drivers plugáveis para FastAPI, Quart, aiohttp, httpx e websockets.
  • 05Ferramenta de scaffolding nb-cli para criar, executar e gerenciar projetos.
  • 06Sistema de plugins para adicionar funcionalidades ao núcleo.

Casos de uso

  • Criar um bot de grupo para QQ ou OneBot com comandos personalizados.
  • Criar um bot para Telegram ou Discord que responda a eventos de conversa.
  • Integrar um bot aos webhooks e eventos do Feishu ou GitHub.
  • Desenvolver um serviço de automação acionado por conversas, que opere em várias plataformas a partir de uma única base de código.

Início rápido

  1. 1

    Leia o guia oficial de início rápido vinculado no README

Antes de usar

  • Alguns adaptadores para plataformas de chat não estão disponíveis ou são mantidos pela comunidade, como o DingTalk, que está procurando alguém para assumir a manutenção.
  • O suporte a adaptadores varia conforme a plataforma, e a interface oficial do QQ muda com frequência.

Em coleções

Chatbots de IA e clientes de chatBibliotecas de concorrência e assincronia

Tópicos

#chatbot#python#async#bot-framework#onebot#qq-bot#telegram-bot#fastapi#bot#cqhttp

Perguntas frequentes

O que é nonebot2?
Um framework assíncrono em Python para criar chatbots que se conectam a várias plataformas de conversa por meio de adaptadores de protocolo plugáveis. NoneBot2 é um framework em Python para criar chatbots. Ele recebe eventos e os encaminha para seus handlers, enquanto os adaptadores de protocolo cuidam da comunicação com cada plataforma de conversa. O framework não implementa nenhuma plataforma por conta própria: ele depende de adaptadores para OneBot, Telegram, Feishu, Discord, GitHub, QQ e várias outras, e adaptadores da comunidade ampliam ainda mais essa lista.
nonebot2 é gratuito? Qual é a licença?
nonebot2 é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
nonebot2 ainda é mantido?
Manutenção ativa. O último commit de nonebot2 foi em 4 de nov. de 2026.
Para que posso usar nonebot2?
Criar um bot de grupo para QQ ou OneBot com comandos personalizados. Criar um bot para Telegram ou Discord que responda a eventos de conversa. Integrar um bot aos webhooks e eventos do Feishu ou GitHub. Desenvolver um serviço de automação acionado por conversas, que opere em várias plataformas a partir de uma única base de código.
Como instalar nonebot2?
Leia o guia oficial de início rápido vinculado no README
Onde consigo nonebot2?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nonebot/nonebot2

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados