HKUDS/nanobot

어떤 프로젝트인가요?

핵심 기능

• 01동일한 로컬 게이트웨이와 저장된 대화를 공유하는 브라우저 WebUI 및 터미널 클라이언트
• 02Telegram, Discord, Slack, WeChat, Email, Mattermost를 포함한 채팅 앱 채널
• 03PDF, Word, Excel, PowerPoint 파일 읽기와 셸 및 웹 검색을 위한 내장 도구
• 04에이전트 작업 공간에 저장되는 세션 기록 및 장기 메모리
• 05MCP 통합, 멀티 에이전트 작업 위임 및 예약 자동화
• 06에이전트를 임베드할 수 있는 Python SDK 및 OpenAI 호환 API

활용 사례

• 자체 서버에서 비공개 AI 어시스턴트를 실행하고 Telegram이나 Discord로 대화하기
• 프로젝트 폴더를 에이전트에 지정해 로컬 보고서나 문서 요약하기
• 채팅 앱을 통해 에이전트가 실행하고 결과를 보고하는 반복 작업 예약하기
• SDK나 HTTP API를 통해 Python 애플리케이션에 에이전트 백엔드 추가하기

빠른 시작

1. 1

   uv로 안정 버전 패키지를 설치합니다

   uv tool install nanobot-ai
2. 2

   최초 브라우저 설정을 위해 WebUI를 엽니다

   nanobot webui
3. 3

   설정 → 모델에서 인증 정보 또는 지원되는 로그인 방식으로 provider 또는 모델 프리셋을 저장합니다

사용 전 알아둘 점

• !지원되는 모델 provider 또는 로컬 모델 서버에 액세스할 수 있어야 합니다. 모델 사용료나 하드웨어 비용은 본인 부담입니다.
• !Python 3.11 이상이 필요합니다.
• !네이티브 터미널 UI는 macOS, glibc Linux, Windows x64용 사전 빌드 wheel에만 포함됩니다. 다른 플랫폼에서는 WebUI 또는 --classic을 사용하세요.

토픽

자주 묻는 질문

nanobot은(는) 무엇인가요?

브라우저 WebUI, 터미널 클라이언트, 채팅 앱 채널, 도구, 메모리 및 MCP를 지원하는 Python 기반 셀프 호스팅 개인 AI 에이전트 프레임워크입니다. nanobot은 Python으로 작성된 경량 셀프 호스팅 개인 AI 에이전트입니다. 자체 컴퓨터나 서버에서 실행하고, 브라우저 WebUI, 터미널 클라이언트 또는 Telegram, Discord, Slack, WeChat, Email, Mattermost 같은 채팅 앱을 통해 사용할 수 있습니다. AI 모델은 직접 설정하는 제공업체에서 가져오며, OpenAI 호환 API와 로컬 모델 서버를 지원합니다.

nanobot은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

nanobot은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

nanobot은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. nanobot의 마지막 커밋은 2026년 10월 20일입니다.

nanobot은(는) 어디에 사용할 수 있나요?

자체 서버에서 비공개 AI 어시스턴트를 실행하고 Telegram이나 Discord로 대화하기 프로젝트 폴더를 에이전트에 지정해 로컬 보고서나 문서 요약하기 채팅 앱을 통해 에이전트가 실행하고 결과를 보고하는 반복 작업 예약하기 SDK나 HTTP API를 통해 Python 애플리케이션에 에이전트 백엔드 추가하기

nanobot는 어떻게 설치하나요?

uv로 안정 버전 패키지를 설치합니다: uv tool install nanobot-ai 최초 브라우저 설정을 위해 WebUI를 엽니다: nanobot webui 설정 → 모델에서 인증 정보 또는 지원되는 로그인 방식으로 provider 또는 모델 프리셋을 저장합니다

nanobot은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/HKUDS/nanobot