HKUDS/nanobot

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

nanobot – 가벼우면서도 자체 호스팅 가능한 개인용 AI 에이전트 프레임워크

무엇인가요 – nanobot은 자신의 머신(또는 자신이 제어하는 서버)에서 개인용 AI 어시스턴트를 실행할 수 있는 오픈소스 파이썬 라이브러리입니다. 브라우저 기반 WebUI, 네이티브 터미널 UI, 그리고 여러 채팅 플랫폼(텔레그램, 디스코드, 슬랙, 위챗, 이메일 등)에 대한 통합 기능을 제공합니다. 핵심은 의도적으로 작고 가독성이 높지만, 도구 사용, 장기 기억, 스케줄된 자동화, 다중 에이전트 위임, OpenAI 호환 HTTP API와 같은 강력한 기능도 지원합니다.

왜 중요한가요 – 전체 스택을 자신이 통제할 수 있습니다: LLM 제공업체(OpenAI, Anthropic, 로컬 Ollama/vLLM 등)를 선택할 수 있고, 에이전트를 백그라운드 게이트웨이로 지속적으로 실행할 수 있으며, 사용자 정의 도구나 "스킬"로 런타임을 확장할 수 있습니다. 런타임이 매우 작고(몇 개의 파이썬 모듈)므로 감사, 수정, 다른 프로젝트에 통합하기가 쉽습니다.

핵심 기능

기능	작동 방식
어디서든 실행 가능	`nanobot webui`로 로컬 브라우저 UI를 시작; `nanobot`로 터미널 UI를 시작; `nanobot gateway`로 지속적인 백그라운드 서비스를 실행.
채팅 앱 연결	텔레그램, 디스코드, 슬랙, 위챗, Mattermost, Linear, 이메일, 일반 웹훅 채널용 내장 어댑터 제공.
도구 사용	에이전트는 쉘 호출, 파일 읽기/쓰기, 웹 검색/다운로드, 이미지 생성, MCP(Micro-Component-Protocol) 서비스 호출, 하위 에이전트 생성이 가능.
기억 기능	세션 기록은 주제별로 유지; 장기 기억은 재시작 후에도 지속되는 Dream 저장소를 통해 제공.
자동화	재발생하는 작업(cron 유사)을 정의하여 UI가 열려 있지 않아도 게이트웨이가 실행.
OpenAI 호환 API	`/v1/chat/completions` 스타일 엔드포인트를 노출하여 다른 프로그램이 OpenAI처럼 nanobot과 통신 가능.
확장 가능한 SDK	파이썬 SDK를 통해 개발자는 에이전트를 자신의 코드에 통합하거나 사용자 정의 스킬/앱을 작성할 수 있음.
배포 옵션	1클릭 Render 블루프린트, Docker/Docker-Compose, systemd/LaunchAgent 서비스, 또는 수동 `uv`/`pip` 설치.

시작하기 (빠른 실행 요약)

설치 – uv tool install nanobot-ai, pip install nanobot-ai, 또는 원라인 설치 스크립트 실행.
UI 실행 – nanobot webui로 http://127.0.0.1:8765가 열림.
모델 설정 – 설정 → 모델 → 제공업체 선택 및 API 키 입력.
채팅 시작 – 주제 생성 후 메시지 입력, 에이전트가 도구를 호출하거나 파일을 편집, 작업을 스케줄링하는 모습 확인.
헤드리스 실행 – nanobot gateway --background로 터미널을 닫아도 에이전트가 계속 실행됨; OpenAI 호환 엔드포인트나 채팅 앱 어댑터로 상호작용 가능.

일반적인 사용 사례

개인 생산성 향상 – 에이전트에게 이메일 초안 작성, 작업 정리, 코드 스니펫 생성을 요청하고, 작업 내용을 지속 가능한 워크스페이스에 저장.
개발자 어시스턴트 – 터미널 UI에서 파일 편집, 테스트 실행, 문서 가져오기 등을 직접 수행.
팀용 봇 – 게이트웨이를 슬랙/디스코드에 공개하여 팀 전체가 동일한 장기 기억과 공유된 자동화를 사용 가능.
자동화 허브 – 일일 보고서, 주기적 웹 스크래핑, 인간이 개입하지 않는 CI 스타일 파이프라인을 스케줄링 가능.
실험 플랫폼 – OpenAI, Anthropic, 또는 로컬 LLM(Ollama, vLLM) 간에 코드 변경 없이 쉽게 전환 가능.

설치 및 배포 참고 사항

Python ≥ 3.11 필요.
미리 빌드된 웨일에는 WebUI(통합된 정적 자산)와 macOS 13+, Linux glibc 2.17+, Windows x64(SSE4.2 필요)용 네이티브 터미널 UI 포함.
소스 설치 시에는 Bun도 필요(터미널 UI 자산 재빌드용).
프로젝트는 Render.com 1클릭 블루프린트를 제공하며, Anthropic API 키와 개인 토큰을 입력하면 게이트웨이 + WebUI를 지속 서비스로 배포 가능.
Docker 이미지 설명은 docs/deployment.md 가이드에 있으며, systemd 서비스나 macOS LaunchAgent로도 게이트웨이 실행 가능.

문서 및 커뮤니티

전체 문서는 nanobot.wiki(다국어)와 리포지토리의 docs/ 폴더에 있음.
지원 및 논의를 위해 디스코드 서버, X(Twitter) 계정, 위챗/피쉬우 링크 제공.
리포지토리에는 CI 배지, 테스트 스위트, MIT 라이선스 포함되어 있어 활발히 유지 관리되는 오픈소스 프로젝트임을 나타냄.

결론

nanobot은 로컬 또는 자체 호스팅이 가능한 컴팩트하고 확장 가능한 개인용 AI 에이전트 런타임을 제공하며, 풍부한 UI 옵션, 다중 채널 채팅 통합, 도구 사용, 기억, 스케줄링 기능을 읽기 쉬운 파이썬 코드베이스로 구현합니다.