TL;DR

nanobot은 소형 에이전트 루프를 중심으로 WebUI, 다중 채팅 앱 연동, 도구 호출, 장기 메모리 Dream, 자동화와 Python SDK 및 OpenAI 호환 API를 통합한 자가호스팅 개인 AI 에이전트 런타임이다. 핵심 작동은 메시지를 수신하면 LLM이 도구 사용 여부를 판단하고 필요 도구를 호출한 뒤 도구 출력과 장기 메모리를 응답 컨텍스트로 다시 주입하는 순환 구조로 이루어져 있다. 이 구조는 코어를 작게 유지하면서도 모델 프리셋과 provider 설정으로 외부 API와 로컬 LLM을 유연하게 라우팅하도록 설계되어 있다. README에 포함된 한 줄 설치 스크립트와 wheel에 번들된 WebUI로 진입 장벽을 낮추었고 다국어 문서와 활발한 릴리스 기록으로 실사용 검증과 확장이 용이하다. 다만 소스 빌드 시 bun/npm과 같은 추가 도구가 필요하고 프로덕션 배포는 별도 Docker 혹은 서비스 설정을 추가로 구성해야 한다.

주요 기능

• 브라우저 기반 WebUI에서 대화 세션과 워크스페이스를 실행하고 관리할 수 있으며 WebUI는 wheel에 번들되어 별도 빌드 없이 사용 가능하다. WebUI는 로컬 WebSocket으로 동작해 기본적으로 127.0.0.1 바인딩을 사용하도록 설계되어 있다. README는 webui 명령과 gateway 명령을 통해 브라우저 접속 절차를 구체적으로 안내한다.
• 다양한 채팅 앱과 연동해 메시지를 수신하고 에이전트 루프에서 처리할 수 있으며 Telegram, Discord, Slack, WeChat, Email, Mattermost 연동을 지원한다고 명시되어 있다. 각 채널로부터 들어온 메시지는 중앙 에이전트 루프에서 LLM 판단에 따라 도구 호출이나 응답 생성에 사용된다. README는 채팅 앱 통합을 위한 별도 문서와 가이드를 제공한다.
• 파일, 셸, 웹 검색, 웹 페치, 이미지 생성, 하위 에이전트 등 외부 도구를 호출하고 도구 실행 결과를 응답 맥락에 포함시킬 수 있는 도구 체인을 제공한다. 도구 호출은 LLM이 필요성을 판단할 때 트리거되며 도구 출력은 다음 응답의 입력 컨텍스트로 사용된다. 자동화 및 예약 작업을 통해 장기 목표 실행과 반복 작업을 처리할 수 있다.
• Python SDK와 OpenAI 호환 API를 통해 통합 지점을 노출하여 외부 시스템에서 에이전트를 호출하거나 프로그램적으로 제어할 수 있다. README는 API와 SDK 문서를 별도 페이지로 제공해 프로바이더 설정과 모델 프리셋 매핑을 복사해서 쓸 수 있게 구성했다. 배포 옵션에는 로컬 서비스, Docker 및 Linux 서비스 형태가 포함되어 있다.

어떻게 동작하는가

nanobot은 소형 에이전트 루프를 중심으로 설계되어 메시지가 들어오면 LLM이 도구 호출 필요성을 판단하고 요구되는 도구를 실행하며 메모리와 스킬을 컨텍스트로 주입하는 방식으로 동작한다. 이 구조는 핵심 경로를 단순하고 읽기 쉬운 상태로 유지하면서 외부 채널, 도구, 장기 메모리 Dream을 모듈식으로 연결할 수 있게 한다. 모델 프리셋과 provider 설정을 사용해 요청을 다양한 외부 제공자나 로컬 서버로 라우팅할 수 있다.

해결 문제

nanobot은 개인 또는 소규모 인프라에서 지속적인 목표와 장기 워크플로를 운영할 때 발생하는 복잡한 통합 문제를 줄인다. 이 프로젝트는 채팅 채널 연동, 도구 실행, 세션 기록과 장기 메모리 보존 기능을 단일 런타임으로 통합해 외부 대형 플랫폼 없이도 연속적 작업을 유지하게 만든다. 또한 작은 코어와 모듈식 확장으로 내부 로직 가독성을 유지해 개발자나 운영자가 직접 스택을 소유하고 맞춤형으로 확장할 수 있게 한다.

지금 주목받는 이유

이 레포는 높은 스타 수와 활발한 릴리스 로그, 다국어 문서화로 커뮤니티 접근성이 높다고 판단된다. 최근 릴리스에서 WebUI 전사 분할, Python SDK 런타임 제어, 자동화 관리 등 실사용 편의 기능이 지속적으로 추가되었다는 점이 가시적이다. README의 풍부한 가이드와 채팅 앱 연동 문서는 실전 도입 사례를 빠르게 구성하게 한다는 점에서 관심을 끌었다.

차별점

• 코어가 작고 읽기 쉽게 설계되어 소스 레벨에서 내부 동작을 빠르게 파악하고 수정할 수 있으며 이는 가벼운 개인 호스팅 목적에 부합한다. README에 따르면 WebUI가 wheel에 번들되어 있어 추가 빌드 없이 배포판에서 바로 사용할 수 있다. 이 접근은 WebUI를 별도 빌드 파이프라인으로 관리해야 하는 도구들보다 초기 설정 진입 장벽을 낮춘다.
• provider-agnostic한 모델 프리셋과 fallback 모델 구조로 외부 API와 로컬 LLM을 동일한 설정 방식으로 관리할 수 있다. README에 제시된 modelPresets 구성은 프리셋 라벨링과 컨텍스트 토큰 한도, 온도 등 실행 매개변수를 한곳에서 제어하게 만든다. 이로 인해 비용·가용성 정책에 따라 런타임 중 모델을 유연하게 전환할 수 있다.
• 장기 메모리 기능인 Dream과 MCP 같은 경량 런타임 제어를 포함해 장기 실행과 자동화를 염두에 둔 통합 기능을 제공한다. 이들 구성 요소는 에이전트가 장기 목표를 지속적으로 추적하고 세션 간 문맥을 유지하도록 설계되어 있다. 통합된 자동화와 예약 시스템은 반복적 작업을 에이전트 내부에서 처리하게 한다.

사용 사례

• 개인 비서형 워크플로에서 장기 목표를 설정하고 주기적 자동화 작업을 실행하며 대화형 세션의 문맥을 유지하는 데 활용할 수 있다. Dream 메모리를 통해 장기간의 정보와 목표 상태를 보존하므로 반복적 확인이나 누적 지식이 필요한 작업에서 유용하다. WebUI와 채널 연동을 통해 사용자는 브라우저 또는 친숙한 메신저에서 동일한 에이전트를 사용할 수 있다.
• 소규모 개발 환경에서 코드 생성, 파일 편집, 차이점 프리뷰와 같은 작업을 에이전트로 자동화해 개발자 생산성을 높일 수 있다. README에 언급된 실시간 파일 편집과 구문 강조 미리보기 기능은 코드 관련 워크플로에 직접 연결되도록 설계되어 있다. Python SDK와 OpenAI 호환 API를 통해 CI 파이프라인이나 자동화 스크립트에서 에이전트를 호출할 수 있다.
• 팀 알림과 운영 자동화용 게이트웨이로 사용해 채팅 앱을 통한 알림, 검색 기반 작업, 외부 웹 도구 호출을 중앙화할 수 있다. README는 Telegram, Slack, Discord, WeChat 등 다수의 채널 연동을 지원한다고 명시해 다양한 협업 환경에서 통일된 에이전트 동작을 구현하게 한다. 로컬 배포나 Docker 서비스로 운영하면 내부 정책에 맞춘 데이터 주권을 유지할 수 있다.

시작하기

가장 빠른 시작 방법은 README의 한 줄 설치 스크립트를 실행해 PyPI에서 패키지를 설치하고 온보드 위저드를 따라가는 것이다. 안정된 배포가 필요하면 python -m pip install nanobot-ai 명령으로 설치한 뒤 nanobot gateway 또는 nanobot webui 명령으로 브라우저 작업공간을 열어 확인하면 된다. 소스 기반 설치는 git 복제 후 python -m pip install . 방식이며 웹 UI 빌드가 필요한 경우 bun 또는 npm이 필요하다.

요구사항

• 런타임은 Python 3.11 이상을 요구하며 README에서 해당 최소 버전이 명시되어 있다.
• 소스에서 WebUI를 빌드하려면 bun 또는 npm이 필요하고 Windows 환경에서는 npm.cmd 관련 수작업 빌드 절차가 안내되어 있다.
• Git은 소스 설치에 필요하며 가상 환경, pipx 또는 uv 같은 도구를 사용해 전역 설치를 피하는 것이 README의 권장 방식이다.

이미지 분석