nanobot이란?
nanobot은 HKUDS가 개발한 무료 오픈소스 셀프호스팅 개인 AI 에이전트 프레임워크로, Python으로 작성되었습니다. 자체 언어 모델을 실행하지 않고, 대신 연결한 모델 주위에 메모리, 도구 접근, 멀티 에이전트 조정, 스케줄링을 감싸고, 그 결과를 웹 UI·터미널·채팅 앱 연동을 통해 제공합니다.
- 제품 유형: 에이전트 프레임워크/오케스트레이션 레이어로, 패키지화된 최종 사용자 앱이나 모델이 아님
- 개발자: HKUDS(GitHub 조직)
- 저장소: github.com/HKUDS/nanobot, 2026년 2월 1일 생성
- 라이선스: MIT, GitHub 저장소의 라이선스 필드로 확인됨
- 문서: nanobot.wiki
- 본 리뷰 기준 GitHub API에 따른 규모: 스타 49,657개, 포크 8,700개(포크 비율 약 18%), 미해결 이슈 868건, 구독자 207명, 기여자 100명 이상, 최신 태그 릴리스 v0.4.0(2026년 10월 28일)
nanobot은 실제로 무엇을 하나?
nanobot은 이미 접근 가능한 모델 위에 네 가지 기능을 얹습니다: 영구 메모리, MCP 도구 연동, 멀티 에이전트 위임, 예약 자동화.
- 영구 메모리: nanobot.wiki에 따르면 세션 기록과 장기 메모리("Dream"이라는 이름으로 문서화됨)를 통해 에이전트는 매 세션마다 처음부터 시작하는 대신 대화 간 맥락을 유지할 수 있음
- MCP 도구 연동: WebUI의 "Apps" 인터페이스를 통해 Model Context Protocol(MCP) 서버에 연결하며, 사전 구성된 연동과 사용자 지정 MCP 서버 추가를 지원
- 멀티 에이전트 위임: 자체 문서에 따르면 nanobot은 단일 에이전트 루프에서 모든 단계를 처리하는 대신 하위 작업을 다른 에이전트에 위임할 수 있음
- 예약 자동화: 에이전트는 실시간 채팅 메시지에 대한 응답뿐 아니라 일정에 따라 실행될 수 있음
- 모델 라우팅: OpenAI 호환 API, 로컬 Ollama, 로컬 vLLM 백엔드를 지원하며, 문서에 설명된 대체 모델 라우팅도 제공
- 세 가지 접근 모드: 브라우저 기반 WebUI(
nanobot webui로 실행), 네이티브 터미널 모드(nanobot으로 실행), Telegram·Discord·Slack·WhatsApp·WeChat·이메일·Mattermost·Feishu·Microsoft Teams·Linear·QQ와의 연동
nanobot 문서가 다루는 것(그리고 다루지 않는 것)
README는 MCP, 첨부 파일, 채팅 채널을 다루지만 프롬프트 캐싱, WhatsApp, 벤치마크는 언급하지 않습니다. 저장소 docs에는 WhatsApp, 스트리밍, 하트비트가 추가로 기재되어 있습니다. 이 섹션은 github.com/HKUDS/nanobot의 README, 같은 저장소의 docs 폴더(채팅 앱 레퍼런스와 설정 가이드), nanobot.wiki를 가장 많이 검색되는 기능별로 확인하여, 문서화된 동작과 추측을 구분할 수 있도록 합니다.
- 아키텍처: README에 따르면 Python 게이트웨이가 WebUI, 터미널, 채팅 앱을 위해 "owns agent execution, sessions, tools, memory, and security policy"를 담당하며, 핵심 에이전트 루프는 "builds context, calls the model, executes requested tools, and returns the result"를 수행합니다. 또한 "Small core: readable internals with MCP, memory, deployment, and automation built in"이라고 적혀 있습니다. 코드 줄 수에 대한 주장은 없습니다.
- MCP 지원: WebUI에서는 "Apps"로 MCP 서버를 연결하고, Agent Plugins를 활성화하고, 로컬 CLI 앱 어댑터를 관리할 수 있습니다. 터미널에서는
@로 앱, MCP 서버, 저장된 세션을 지정할 수 있습니다. MCP에 특화된 안정성 보장이나 테스트 결과는 문서화되어 있지 않습니다. - 프롬프트 캐싱: README와 설정 가이드는
cache_control이나 Anthropic 프롬프트 캐싱을 언급하지 않으며, 캐시 적중 수치도 공개하지 않습니다. WebUI의 컨텍스트 표시기가 "cache reuse when the provider reports it"를 보여 준다는 것, 캐시 적중이 "still depend on the provider"라는 것, 제공자가 프롬프트 캐시를 더 오래 유지한다면 유휴 압축 시간 제한을 늘릴 수 있다는 것만 적혀 있습니다. - 스트리밍: README에는 명시되어 있지 않지만 채팅 앱 레퍼런스와 설정 가이드에는 있습니다. Discord와 Feishu 응답은 기본적으로 스트리밍되며(
streaming기본값은true이고 끌 수 있음), 모델 호출에는 기본 90초의 스트림 유휴 시간 제한이 적용됩니다(NANOBOT_STREAM_IDLE_TIMEOUT_S). - 멀티모달 및 파일: WebUI에서는 "Attach documents or images"가 가능하고, 터미널은 클립보드 이미지 붙여넣기(
Ctrl+V또는Alt+V)를 지원하며, 도구 목록에는 이미지 생성이 포함됩니다. v0.4.0 릴리스 노트는 WebUI에 로컬 파일 및 동영상 첨부, 이미지 썸네일, 파일 카드를 추가했다고 밝힙니다. - 채팅 채널: 저장소의 채팅 앱 레퍼런스는 Telegram, Discord, Slack, Feishu, WhatsApp(QR 코드로 연결), WhatsApp Agent Platform, WeChat, QQ, 이메일, Mattermost, Linear 등을 다룹니다. README 자체는 Telegram, Discord, Slack, WeChat, 이메일, Mattermost, Linear와 "other channels"를 언급하고, "Why nanobot" 목록에는 Feishu와 Microsoft Teams가 추가됩니다.
- 하트비트: README가 아니라 설정 가이드에 문서화되어 있습니다. 내장 하트비트 작업은
nanobot gateway에서 기본으로 켜져 있고, 1,800초마다(gateway.heartbeat.intervalS)HEARTBEAT.md를 확인하여 조치가 필요한 결과만 가장 최근에 활동한 채팅으로 보냅니다. - 안정성: 문서에는 순서가 있는 대체 모델 체인(
agents.defaults.fallbackModels)과 메시지 전송 재시도(기본 3회, 대기 시간 1초 후 2초)가 설명되어 있습니다. 한계도 명시되어 있습니다. 게이트웨이를 재시작하면 놓친 예약 시각은 다시 실행되지 않으며, 중단된 서브에이전트 작업도 자동으로 다시 시작되지 않습니다. v0.4.0은 대화 기록을 SQLite로 옮겼습니다. - 벤치마크: README와 이 리뷰가 읽은 문서 페이지 모두 벤치마크를 주장하지 않으며, 이 리뷰도 실행하지 않았습니다.
플랫폼, 가격, 라이선스
플랫폼
- nanobot의 공식 설명:
- GitHub 저장소에 따르면 설치 스크립트를 통해 Linux, macOS, Windows에 셀프호스팅하거나, Docker / Docker Compose로 영구 서비스로 배포할 수 있음.
비용
- nanobot의 공식 설명:
- 무료 오픈소스. 연결한 백엔드 모델이나 API 비용만 지불(로컬 Ollama나 vLLM 모델을 사용하면 비용 없음) — 별도의 유료 nanobot 요금제는 없음.
라이선스
- nanobot의 공식 설명:
- GitHub 저장소의 라이선스 필드로 확인된 MIT 라이선스.
하드웨어
- nanobot의 공식 설명:
- 자체 GPU나 최소 RAM 요구 사항 없음 — 모델을 호출하는 에이전트 루프일 뿐, 추론 엔진이 아님. 실제 하드웨어 필요량은 선택한 백엔드 모델에 전적으로 좌우됨.
설치 방법
- nanobot의 공식 설명:
- nanobot.wiki와 GitHub README에 따르면 macOS/Linux 및 Windows PowerShell용 한 줄 설치 스크립트, 또는
pip install nanobot-ai/uv tool install nanobot-ai. 아래 "nanobot 설치" 섹션 참고.
설치 단계는 릴리스마다 바뀔 수 있으므로, 명령을 실행하기 전에 nanobot.wiki에서 최신 설치·배포 안내를 직접 확인하세요.
nanobot 설치
nanobot은 한 줄 스크립트, 패키지 매니저, 또는 소스코드를 통해 무료로 설치할 수 있습니다 — 유료 요금제나 라이선스 키는 없습니다.
Install method | Command |
|---|---|
| macOS / Linux(설치 스크립트) | curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh |
| Windows(PowerShell) | irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex |
| uv 사용 | uv tool install nanobot-ai |
| pip 사용 | python -m pip install nanobot-ai |
| 소스코드에서 설치 | github.com/HKUDS/nanobot을 git clone한 뒤 가상 환경을 만들고 pip install -e . 실행 |
| Docker / Docker Compose | 영구 서비스 배포용으로 GitHub 저장소에 문서화되어 있음 — 실행 전 저장소의 최신 compose 파일을 확인하세요. |
| 웹사이트 및 문서 | nanobot.wiki |
GitHub README에 따르면 Python 3.11 이상이 필요하며, Git과 Bun은 소스코드 설치 시에만 필요합니다. 설치 후 브라우저 인터페이스는 nanobot webui, 터미널 모드는 nanobot으로 실행하세요.
nanobot은 누구에게 적합한가?
nanobot은 이미 언어 모델을 운영하거나 호출하고 있으며, 패키지화된 올인원 비서 앱 대신 그 주위에 영구 메모리, 도구 접근, 자동화를 원하는 사람에게 적합합니다.
다음에 해당하면 nanobot을 사용하세요
- 이미 OpenAI 호환 API에 접근할 수 있거나 Ollama나 vLLM으로 로컬 모델을 운영하고 있으며, 완전한 추론 스택 대신 그 위에 에이전트 레이어를 원함
- 매 대화마다 처음부터 시작하는 대신 과거 세션을 기억하는 에이전트를 원함
- 에이전트가 질문에 답하는 것을 넘어 외부 시스템에 대해 작업을 수행할 수 있도록 MCP 도구 서버를 연결해야 함
- 하나의 인터페이스에 묶이지 않고 브라우저, 터미널, Telegram이나 Slack 같은 채팅 앱에서 동일한 에이전트에 접근하고 싶음
- Python 서비스를 셀프호스팅하는 데 거부감이 없고 호스팅·관리형 제품을 찾고 있지 않음
다음에 해당하면 다른 대안을 찾아보세요
- 설정이 필요 없는 다운로드형 데스크톱 앱 하나를 원함 — nanobot은 완성품용 원클릭 설치 프로그램이 아니라 셀프호스팅 프레임워크임
- 지원 계약과 SLA를 갖춘 공급업체 후원 제품이 필요함 — 본 리뷰는 nanobot 뒤에 투자 라운드나 상업적 회사가 있다는 근거를 찾지 못함
- 설치 스크립트, pip 패키지, Docker 컨테이너 실행에 익숙하지 않음
- 독립적으로 감사된 오랜 실적을 원함 — 본 리뷰 기준 nanobot 저장소는 생긴 지 약 9개월밖에 되지 않음
nanobot이 적합하지 않은 경우
완성되고 패키지화된 비서 앱을 원하거나, 도구를 도입하기 전에 독립적으로 검증된 오랜 실적이 필요하다면 nanobot은 좋은 선택이 아닙니다.
- 추론 엔진이 아님 — 자체 GPU/VRAM 요구 사항은 없지만, 자체적으로 모델 추론도 하지 않음; 실제 추론을 수행하는 모델을 위해 여전히 Ollama, vLLM, 또는 API 키가 필요함
- 완성도 높은 올인원 데스크톱 앱이 아님 — 직접 구성해야 하는 셀프호스팅 프레임워크이며, 설정 난이도는 원클릭 채팅 앱보다 CrewAI나 agent-zero에 더 가까움
- 본 리뷰가 확인할 수 있었던 투자 라운드나 회사의 후원이 없음 — 독립적으로 유지되는 커뮤니티 주도 프로젝트로 취급할 것
- 위에서 언급한 스타 수 관련 유의사항에서 자유롭지 않음 — 본 리뷰는 GitHub 다른 곳에서 동일한 마케팅 문구를 사용하는 모방 저장소를 발견했으므로, "nanobot"에 대해 인용된 스타 수를 신뢰하기 전에 github.com/HKUDS/nanobot을 구체적으로 보고 있는지 확인할 것
- 오랫동안 자리 잡은 프로젝트가 아님 — 저장소는 2026년 2월 1일에 생성되어, AutoGPT나 Open Interpreter 같은 프레임워크의 다년간 실적이 없음
nanobot 평가 시 흔한 오해
nanobot에 대한 혼란은 대부분 이름이 같은 무관한 프로젝트와 혼동하거나 성장 수치를 잘못 해석하는 데서 비롯됩니다.
오해 1: nanobot-ai/nanobot과 혼동
Obot 팀이 "Build MCP Agents"로 소개하는, 2025년 5월 16일경 생성되고 약 1,343 스타를 보유한 별개의 무관한 GitHub 프로젝트인 nanobot-ai/nanobot이 같은 이름을 사용합니다. 본 리뷰는 HKUDS/nanobot만을 다룹니다 — 둘 중 하나를 설치하기 전에 GitHub URL의 조직명을 확인하세요.
오해 2: 스타 수를 감사된 성장 신호로 취급
2026년 2월에 생성된 저장소가 49,657 스타를 보유한 것은 이례적으로 빠르며, GitHub 검색을 하면 동일한 마케팅 설명을 사용하는 모방 저장소가 발견됩니다. 포크 수(8,700), 미해결 이슈(868), 기여자 수(100 이상)는 대체로 자연스러운 활동을 시사하지만, 본 리뷰는 스타 이력을 독립적으로 감사하지 않았습니다 — 본 리뷰의 스냅샷을 현재 상태로 인용하는 대신 GitHub에서 직접 최신 수치를 확인하세요.
오해 3: nanobot이 모델을 직접 실행할 것이라 기대
nanobot은 추론을 수행하지 않기 때문에 CPU만으로 동작합니다 — OpenAI 호환 API, 로컬 Ollama 서버, 또는 로컬 vLLM 서버를 호출할 뿐입니다. 하드웨어 요구 사항은 nanobot이 아니라 선택한 백엔드 모델에서 비롯됩니다.
오해 4: 유료 요금제가 존재한다고 가정
nanobot은 MIT 라이선스 하에 무료 오픈소스이며, 별도의 유료 요금제가 없습니다. 비용은 연결한 백엔드 모델이나 API에서만 발생합니다.
경쟁 제품 및 대안
nanobot은 AutoGPT, Open Interpreter, agent-zero, CrewAI 같은 다른 셀프호스팅 에이전트 프레임워크와 가장 자주 비교됩니다 — 주요 차별점은 이들 중 하나에만 특화하는 대신 영구 메모리, MCP 도구, 멀티 에이전트 위임, 채팅 앱 연동을 하나의 프레임워크에 결합한다는 점입니다.
Tool | Best known for | Link |
|---|---|---|
| AutoGPT | 목표 지향적 작업 체인에 초점을 맞춘 최초기 자율 에이전트 프레임워크 중 하나 | AutoGPT 리뷰 |
| Open Interpreter | 모델이 로컬에서 코드를 실행해 작업을 완료하게 하며, 단순함으로 인기 | Open Interpreter 리뷰 |
| agent-zero | 영구 환경을 갖춘 Docker 기반 셀프호스팅 범용 에이전트 프레임워크 | agent-zero 리뷰 |
| CrewAI | 역할 기반 에이전트 팀에 초점을 맞춘 멀티 에이전트 오케스트레이션 프레임워크 | CrewAI 리뷰 |
이 목록은 동일한 셀프호스팅 에이전트 프레임워크 부문에서 nanobot과 흔히 비교되는 도구들을 반영한 것이며, PromptQuorum의 독립적인 순위가 아닙니다 — 선택하기 전에 각 도구의 현재 기능 세트를 확인하세요.
자주 묻는 질문
nanobot이란 무엇인가요?
nanobot(nanobot.wiki)은 HKUDS가 개발한 무료 오픈소스(MIT) 셀프호스팅 개인 AI 에이전트 프레임워크로, 연결한 모델에 영구 메모리, MCP 도구 연동, 멀티 에이전트 위임, 예약 자동화를 추가합니다.
nanobot은 무료인가요?
네, nanobot 자체는 MIT 라이선스 하에 무료 오픈소스이며 별도의 유료 요금제가 없습니다. 연결한 백엔드 모델이나 API 비용만 지불하면 됩니다.
nanobot은 어떻게 설치하나요?
nanobot.wiki와 GitHub README에 따르면, macOS/Linux 또는 Windows PowerShell용 한 줄 설치 스크립트를 실행하거나 pip install nanobot-ai 또는 uv tool install nanobot-ai로 설치합니다. Python 3.11 이상이 필요합니다.
nanobot은 자체 AI 모델을 실행하나요?
아니요. nanobot은 추론 엔진이 아니라 에이전트 프레임워크로, OpenAI 호환 API, 로컬 Ollama 서버, 또는 로컬 vLLM 서버를 호출합니다. 자체 GPU 요구 사항이 없으며, 하드웨어 필요량은 선택한 백엔드 모델에 따라 달라집니다.
nanobot은 어떤 채팅 앱과 연동되나요?
저장소의 채팅 앱 레퍼런스에 따르면 Telegram, Discord, Slack, Feishu, WhatsApp, WeChat, QQ, 이메일, Mattermost, Linear 등입니다. README에는 Microsoft Teams도 나열되어 있으며, 자체 웹 UI와 터미널 모드도 제공합니다.
nanobot은 nanobot-ai/nanobot과 같은 것인가요?
아니요. nanobot-ai/nanobot은 Obot 팀이 만든 별개의 무관하고 더 작은 "Build MCP Agents" 프로젝트입니다(약 1,343 스타, 2025년 5월 16일 생성). 본 리뷰는 HKUDS/nanobot만을 다룹니다 — 설치 전에 GitHub 조직명을 확인하세요.
이렇게 새로운 프로젝트인데 nanobot은 왜 GitHub 스타가 이렇게 많나요?
2026년 2월 1일에 생성된 저장소가 49,657 스타를 보유한 것은 이례적으로 빠르며, GitHub 검색을 하면 동일한 마케팅 문구를 사용하는 모방 저장소가 발견됩니다. 약 18%의 포크 비율, 수백 건의 미해결 이슈, 100명 이상의 기여자는 대체로 자연스러운 활동을 시사하지만, 본 리뷰는 스타 이력을 독립적으로 감사하지 않았습니다 — GitHub에서 직접 최신 수치를 확인하세요.
MCP란 무엇이고 nanobot은 이를 어떻게 사용하나요?
MCP(Model Context Protocol)는 AI 에이전트가 전용 서버를 통해 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 표준입니다. nanobot은 WebUI의 "Apps" 인터페이스를 통해 MCP 서버에 연결하며, 사전 구성된 연동과 사용자 지정 서버 지원을 제공합니다.
nanobot은 멀티 에이전트 워크플로를 지원하나요?
네. 자체 문서에 따르면 단일 에이전트 루프에서 모든 단계를 처리하는 대신 하위 작업을 다른 에이전트에 위임할 수 있습니다.
PromptQuorum은 nanobot의 주장을 독립적으로 검증했나요?
본 리뷰는 nanobot의 GitHub README, nanobot.wiki 문서, GitHub API를 근거로 하며, PromptQuorum이 메모리나 멀티 에이전트 성능을 실제로 벤치마크한 것이 아닙니다.
nanobot은 프롬프트 캐싱(prompt caching)을 지원하나요?
문서화된 기능으로는 없습니다. README와 설정 가이드는 cache_control이나 Anthropic 프롬프트 캐싱을 언급하지 않습니다. 관련된 표현은 WebUI 컨텍스트 표시기의 "cache reuse when the provider reports it"와, 캐시 적중이 "still depend on the provider"라는 주석뿐입니다. 캐싱이 적용된다고 가정하기 전에 사용하는 모델 제공자의 문서를 확인하세요.
nanobot은 WhatsApp을 지원하나요?
네. 저장소의 채팅 앱 레퍼런스에 따르면 QR 코드를 스캔해 연결하는 WhatsApp 채널(nanobot channels login whatsapp)과, 에이전트 API 토큰을 쓰는 별도의 WhatsApp Agent Platform 채널이 있습니다. README에는 WhatsApp가 언급되어 있지 않으므로 설치하는 버전의 문서를 확인하세요.
nanobot은 응답 스트리밍을 지원합니까?
일부 지원합니다. README가 아니라 채팅 앱 레퍼런스와 설정 가이드에 기재되어 있습니다. Discord와 Feishu 응답은 기본적으로 스트리밍되며(streaming 기본값은 true), 모델 호출에는 90초의 스트림 유휴 시간 제한이 적용됩니다(NANOBOT_STREAM_IDLE_TIMEOUT_S). 다른 모든 채널이 토큰 단위로 스트리밍하는지는 이 리뷰가 읽은 페이지에 나와 있지 않습니다.
nanobot은 이미지와 파일(멀티모달)을 지원하나요?
부분적으로 문서화되어 있습니다. WebUI에서는 문서나 이미지를 첨부할 수 있고, 터미널은 클립보드 이미지 붙여넣기를 지원하며, 도구 목록에는 이미지 생성이 포함됩니다. 실제로 어떤 이미지 입력이 동작하는지는 nanobot 자체가 추론을 실행하지 않으므로 연결한 백엔드 모델에 달려 있습니다.
nanobot의 아키텍처는 어떻게 되나요?
README에 따르면 Python 게이트웨이가 에이전트 실행, 세션, 도구, 메모리, 보안 정책을 담당하며, WebUI·터미널·채팅 앱은 이 하나의 런타임을 쓰는 클라이언트입니다. 핵심 에이전트 루프는 컨텍스트를 구성하고, 모델을 호출하고, 요청된 도구를 실행한 뒤 결과를 반환합니다. nanobot은 모델을 직접 실행하지 않고 OpenAI 호환 API, 로컬 Ollama 서버, 로컬 vLLM 서버를 호출합니다.
nanobot에 벤치마크가 있나요?
nanobot README는 벤치마크를 주장하지 않으며 PromptQuorum도 실행하지 않았습니다. 다른 곳에서 인용되는 nanobot 성능 수치는 검증되지 않은 것으로 취급하세요.