Repolode
제출하기
nonebot

nonebot/nonebot2

플러그형 프로토콜 어댑터를 통해 여러 채팅 플랫폼에 연결하는 비동기 Python 챗봇 프레임워크입니다.

GitHub에서 보기웹사이트
스타
7,779
포크
659
열린 이슈
51
마지막 커밋
13시간 전

어떤 프로젝트인가요?

NoneBot2는 챗봇을 만들기 위한 Python 프레임워크입니다. 들어오는 이벤트를 처리해 핸들러로 전달하며, 각 채팅 플랫폼과의 통신은 프로토콜 어댑터가 담당합니다. 프레임워크 자체는 어떤 플랫폼도 직접 구현하지 않고 OneBot, Telegram, Feishu, Discord, GitHub, QQ 등의 어댑터에 의존하며, 커뮤니티 어댑터를 통해 지원 플랫폼을 더 늘릴 수 있습니다.

Python 타입 어노테이션과 비동기 I/O를 기반으로 하므로 하나의 프로세스에서 많은 메시지를 동시에 처리할 수 있습니다. 드라이버 계층을 통해 FastAPI나 Quart 같은 웹 프레임워크에서 실행하거나, aiohttp, httpx, websockets를 클라이언트로 사용할 수 있으며, 필요에 따라 이들을 교체하거나 조합할 수 있습니다.

프로젝트에는 프로젝트를 생성하고 실행하는 스캐폴딩 도구 nb-cli가 포함되어 있으며, 코어에 기능을 추가할 수 있는 플러그인 생태계도 지원합니다.

핵심 기능

  • 01Python 비동기 I/O를 기반으로 한 비동기 메시지 처리.
  • 02OneBot, Telegram, Feishu, Discord, QQ 등을 위한 프로토콜 어댑터.
  • 03에디터의 타입 검사에 유용한 전체 타입 어노테이션.
  • 04FastAPI, Quart, aiohttp, httpx, websockets를 지원하는 플러그형 드라이버.
  • 05프로젝트 생성, 실행, 관리를 위한 nb-cli 스캐폴딩 도구.
  • 06코어에 기능을 추가하는 플러그인 시스템.

활용 사례

  • 사용자 지정 명령어를 지원하는 QQ 또는 OneBot 기반 그룹 봇 구축.
  • 채팅 이벤트에 응답하는 Telegram 또는 Discord 봇 제작.
  • Feishu 또는 GitHub 웹훅과 이벤트에 봇 연동.
  • 하나의 코드베이스에서 여러 플랫폼을 지원하는 채팅 기반 자동화 서비스 개발.

빠른 시작

  1. 1

    README에 링크된 공식 빠른 시작 가이드를 읽으세요

사용 전 알아둘 점

  • DingTalk와 같은 일부 채팅 플랫폼 어댑터는 사용할 수 없거나 커뮤니티에서 유지 관리합니다. DingTalk는 현재 유지 관리 담당자를 찾고 있습니다.
  • 어댑터 지원 여부는 플랫폼마다 다르며 QQ 공식 인터페이스는 자주 변경됩니다.

포함된 컬렉션

AI 챗봇 및 채팅 클라이언트동시성 및 비동기 라이브러리

토픽

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

자주 묻는 질문

nonebot2은(는) 무엇인가요?
플러그형 프로토콜 어댑터를 통해 여러 채팅 플랫폼에 연결하는 비동기 Python 챗봇 프레임워크입니다. NoneBot2는 챗봇을 만들기 위한 Python 프레임워크입니다. 들어오는 이벤트를 처리해 핸들러로 전달하며, 각 채팅 플랫폼과의 통신은 프로토콜 어댑터가 담당합니다. 프레임워크 자체는 어떤 플랫폼도 직접 구현하지 않고 OneBot, Telegram, Feishu, Discord, GitHub, QQ 등의 어댑터에 의존하며, 커뮤니티 어댑터를 통해 지원 플랫폼을 더 늘릴 수 있습니다.
nonebot2은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
nonebot2은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
nonebot2은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. nonebot2의 마지막 커밋은 2026년 11월 6일입니다.
nonebot2은(는) 어디에 사용할 수 있나요?
사용자 지정 명령어를 지원하는 QQ 또는 OneBot 기반 그룹 봇 구축. 채팅 이벤트에 응답하는 Telegram 또는 Discord 봇 제작. Feishu 또는 GitHub 웹훅과 이벤트에 봇 연동. 하나의 코드베이스에서 여러 플랫폼을 지원하는 채팅 기반 자동화 서비스 개발.
nonebot2는 어떻게 설치하나요?
README에 링크된 공식 빠른 시작 가이드를 읽으세요
nonebot2은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nonebot/nonebot2

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트