TL;DR

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

핵심 포인트

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

이미지 분석