nanobot
혼자 돌려 쓰는 자기 호스팅 개인 에이전트 런타임
pip install nanobot-ai브라우저 UI, 터미널, 메신저 앱에서 같은 에이전트를 부르는 자기 호스팅 런타임입니다. 파일과 셸, 웹 검색과 페치, MCP, 크론, 이미지 생성, 서브에이전트를 도구로 쓰고 세션 이력과 장기 기억을 따로 관리합니다. 텔레그램, 디스코드, 슬랙, 위챗, 이메일, 매터모스트를 붙일 수 있고 OpenAI 호환 API 와 파이썬 SDK 를 함께 내줍니다. 코어를 작고 읽을 수 있게 유지하는 것을 목표로 해서 내부를 뜯어 고치기 쉽습니다. 오래 도는 목표와 예약 자동화를 걸어 두면 대화가 끊겨도 작업이 이어집니다.
판단
이럴 때 씁니다
- 개인용 에이전트를 남의 서버가 아니라 내 기계에서 돌리고 싶을 때
- 메신저에서 부르는 경로와 브라우저 UI 를 함께 쓰고 싶을 때
- 예약 자동화와 장기 목표를 걸어 두고 계속 돌게 하고 싶을 때
이럴 땐 쓰지 마세요
- 코드 편집이 주목적이면 코딩 에이전트 쪽이 맞습니다
- 팀 단위 권한 관리와 감사 로그가 필요하면 기능이 얇습니다
- 설치와 운영을 직접 해야 하므로 관리형 서비스보다 손이 갑니다
차별점
- 브라우저 UI, 터미널, 메신저 앱이 같은 런타임을 공유합니다.
- 코어를 작고 읽을 수 있게 유지하는 것을 명시적 목표로 둡니다.
- OpenAI 호환 API 와 파이썬 SDK 를 함께 내주어 다른 코드에 붙이기 쉽습니다.
워크플로
- 01PyPI 패키지를 설치하거나 설치 스크립트를 한 줄로 돌립니다.
- 02nanobot webui 로 브라우저 작업대를 띄웁니다.
- 03설정 화면에서 첫 제공자와 모델을 넣습니다.
- 04필요한 도구와 MCP 서버를 켜고 메신저 채널을 붙입니다.
- 05오래 도는 목표나 크론 자동화를 걸어 둡니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install nanobot-ai | 안정판을 설치합니다. |
nanobot webui | 게이트웨이를 띄우고 브라우저 작업대를 엽니다. |
curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh | 설치와 첫 설정을 한 번에 진행합니다. |
함정
설치 전에 확인하세요
- 파이썬 3.11 이상이 필요합니다. 소스 설치를 하려면 Git 과 Bun 도 있어야 합니다.
- 배포 패키지는 첫 실행 때 버전이 맞는 TUI 아카이브를 체크섬을 확인하며 내려받습니다. 오프라인 환경이면 이 단계가 막힙니다.
- 설치 스크립트는 시스템 전역 pip 설치를 피해 가상환경이나 uv, pipx 로 넣습니다. 기존 환경과 섞이지 않게 어디에 깔렸는지 확인해 두는 편이 좋습니다.
비교
에이전트 프레임워크 대부분은 라이브러리이거나 완성된 앱 둘 중 하나입니다. 이쪽은 자기 호스팅 런타임으로 두 성격을 겹쳐서, 바로 켜서 쓰다가 필요하면 SDK 로 감싸 다른 서비스에 붙입니다. 대신 서버를 직접 띄우고 관리해야 합니다.
최근 변경
0.3.0 에 260개 풀리퀘스트가 들어갔고 새 기여자가 38명 늘었습니다. nanobot webui 한 줄이면 로컬 UI 를 준비하고 게이트웨이를 띄운 뒤 브라우저 작업대를 여는 흐름이 됐고, 새로 설치한 경우에는 안내 설정이 함께 뜹니다.