nanobot: 홍콩대가 만든 초경량 셀프 호스팅 개인 AI 에이전트

Orca: Claude Code, Codex, Cursor를 병렬로 실행하는 ADE • herdr: 여러 AI 에이전트를 동시에 실행하기 위한 터미널 멀티플렉서

nanobot이란 무엇인가? #

nanobot은 초경량 오픈소스 셀프 호스팅 Python 개인 AI 에이전트 프레임워크로, dibi8이 따로 다룬 Vibe-Trading과 같은 홍콩대 데이터 사이언스 랩인 HKUDS가 만들었다. 많은 에이전트 프레임워크가 점점 무거운 플랫폼으로 커지는 것과 달리, nanobot은 반대 방향을 지향한다: 코어는 작고 읽기 쉽지만 도구, 장기 메모리, MCP, 모델 라우팅, 멀티 에이전트 위임, 예약 자동화, OpenAI 호환 API는 다 갖췄다.

🔗 GitHub: https://github.com/HKUDS/nanobot 🌐 홈페이지: https://nanobot.wiki

2026년 2월 MIT 라이선스로 처음 공개됐고, 2026년 7월 말 기준 4만 6300개 이상의 GitHub 스타를 기록했다. 프로젝트 자체 리서치는 눈에 띄는 격차를 하나 발견했다: GitHub 트렌딩 페이지가 한때 635개 스타로만 표시했지만 실제 API 검증 수치는 수만 개에 달해, 7134% 저평가됐다 — 이들이 조사 과정에서 발견한 가장 큰 격차였다.

할 수 있는 것 #

• 브라우저 WebUI 또는 터미널로 실행
• Telegram, Discord, Slack, 위챗, 페이슈, Teams, 이메일, Mattermost에 연결
• 파일, 셸, 웹 검색, 웹 페치, MCP, 예약 작업, 이미지 생성, 서브에이전트 등의 도구 사용
• Dream이라 부르는 컴포넌트로 세션 기록과 장기 메모리 유지
• 장기 목표와 예약 자동화 실행
• 커스텀 연동을 위한 Python SDK와 OpenAI 호환 API 제공
• 장기 실행되는 로컬 또는 서버 사이드 에이전트 게이트웨이로 배포

설치 #

Python 3.11 이상 필요.

원커맨드 설치(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

PyPI에서 nanobot-ai를 설치/업그레이드하고, 새 데스크톱 설치라면 nanobot webui를 실행해 Settings → Models에서 첫 프로바이더를 설정하게 한다.

다른 설치 방법:

uv tool install nanobot-ai

python -m pip install nanobot-ai

소스에서 설치(WebUI 빌드에 bun이나 npm 필요):

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
python -m pip install .

빠른 시작 #

브라우저 워크벤치를 여는, 권장되는 첫 실행 방식:

nanobot webui

이어서: Settings → Models에서 프로바이더/모델을 고르고, Hello!를 보내 연결을 확인한 뒤, 실제 프로젝트 작업 전에 워크스페이스를 선택한다.

터미널을 닫아도 계속 실행되게 하기:

nanobot webui --background
nanobot gateway status
nanobot gateway logs

게이트웨이 우선 워크플로를 선호한다면(OpenClaw에서 넘어왔다면 익숙할 것):

nanobot gateway

브라우저 없이 터미널에서만, 상시 채널 없이:

nanobot agent
nanobot agent -m "Hello!"   # 일회성, 스크립트에 적합

아키텍처 #

nanobot은 작은 에이전트 루프를 중심에 두고 모든 것을 조직한다: 메시지가 채팅 앱에서 들어오면 LLM이 도구가 필요한지 판단하고, 메모리나 스킬은 필요할 때만 컨텍스트로 끌어와진다 — 위에 무거운 오케스트레이션 레이어를 얹지 않는다. 채널, 도구, 배포 옵션이 계속 늘어나도 시스템이 하나의 거대한 덩어리로 변하지 않고 핵심 경로가 읽기 쉽고 확장하기 쉽게 유지된다는 것이 목표다.

배포 #

원클릭 Render 배포가 저장소에 직접 문서화돼 있다(ANTHROPIC_API_KEY와 비공개 NANOBOT_WEB_TOKEN을 요구한 뒤 영구 저장소를 프로비저닝한다 — 영구 디스크는 Render 유료 플랜이 필요하다는 점에 유의).

셀프 호스팅은 Docker, Docker Compose, Linux 서비스, macOS LaunchAgent 설정까지 문서화돼 있다.

모델·프로바이더 자유도 #

nanobot은 하나의 LLM 벤더에 묶이지 않는다: OpenAI 호환 API를 폭넓게 지원하고, Ollama를 통한 로컬 LLM, vLLM이나 다른 로컬 OpenAI 호환 서버 경로도 별도로 문서화돼 있다 — 원한다면 완전히 오프라인 상태로 셀프 호스팅 모델에 대해 돌릴 수 있다는 뜻이다.

사용 사례 #

1. 채팅 앱 안에 사는 개인 에이전트 #

Telegram이나 위챗을 한 번 연결하면, 데스크톱 터미널뿐 아니라 휴대폰에서도 같은 지속 메모리를 가진 에이전트와 상호작용할 수 있다.

2. 무거운 플랫폼 없이 장기 자동화 #

nanobot gateway --background로 예약 작업과 채널 연결을 가벼운 서비스로 상시 유지하면서, 대형 엔터프라이즈 에이전트 플랫폼을 도입하지 않아도 된다.

3. 완전히 로컬, 셀프 호스팅 에이전트 #

Ollama나 로컬 vLLM 서버와 조합해, 데이터가 자체 인프라를 벗어나지 않는 개인 에이전트를 만든다.

4. 멀티 에이전트 위임 실험 #

내장된 서브에이전트 도구로 별도 오케스트레이션 인프라를 구축하지 않고도 위임 패턴을 실험한다.

관련 저장소 #

관련 글 #

• Vibe-Trading: 홍콩대가 만든 오픈소스 시장 리서치 에이전트, 트레이딩 봇이 아니다 — 같은 랩, 완전히 다른 영역
• Orca: Claude Code, Codex, Cursor를 병렬로 실행하는 ADE — 코딩 에이전트 전용으로 설계된, 개인 AI 인프라에 대한 또 다른 접근

결론 #

nanobot은 개인 AI 에이전트 프레임워크가 유능해지기 위해 반드시 무거운 플랫폼이 될 필요는 없다는 데 베팅한다 — 작은 코어, 자체 WebUI, 폭넓은 채팅 앱 연결, 완전한 셀프 호스팅(완전 로컬 모델 포함)만으로도 대형 에이전트 플랫폼의 운영 부담 없이 많은 영역을 커버한다. GitHub 트렌딩 페이지가 7000% 넘게 저평가했던 시작점에서 4만 6000개 이상의 스타로 성장한 것은, 사람들이 일단 발견하고 나면 “작은 코어 + 셀프 호스팅"이라는 포지셔닝이 실제로 통한다는 것을 보여준다.

추천 대상: 완전히 자신이 통제하는 개인 AI 에이전트를 원하는 개발자 — 셀프 호스팅되고, 채팅 앱으로 접근 가능하며, 선택적으로 완전히 로컬로 돌아가면서도 크고 무거운 에이전트 플랫폼은 도입하고 싶지 않은 경우.

GitHub: https://github.com/HKUDS/nanobot

셀프 호스팅 추천 인프라 #

nanobot은 애초에 장기 실행 게이트웨이로 셀프 호스팅되도록 설계됐다:

• DigitalOcean — 14개 이상의 글로벌 리전, 60일간 200달러 무료 크레딧, 상시 가동되는 nanobot gateway 인스턴스에 흔히 쓰인다.
• HTStack — 중국 본토에서 지연 시간이 짧은 홍콩 VPS, 위챗/페이슈 채팅 앱 연동에 특히 유용하다. dibi8.com이 호스팅되는 것과 같은 IDC다.

제휴 링크입니다 — 추가 비용 없이 dibi8.com 운영을 돕습니다.

최종 업데이트: 2026-07-29

참고 자료 #

• nanobot
• nanobot.wiki
• Vibe-Trading
• Claude Code