nanobot: un agente personal autoalojado, ligero y extensible

Todo lo que hay que saber sobre HKUDS/nanobot: un entorno en Python para ejecutar un agente personal en el navegador, terminal o aplicaciones de mensajería, con memoria, herramientas, MCP y automatización.

Qué es nanobot

nanobot es un marco de agentes personales de código abierto y autoalojables. Su núcleo ejecuta un bucle de agente: recibe mensajes de una WebUI, la terminal o canales de chat; consulta un modelo; y añade herramientas, memoria o habilidades como contexto cuando hacen falta. El resultado puede mantenerse como una pasarela local o de servidor de larga duración.

El repositorio documenta una WebUI, herramientas de archivos, intérprete de órdenes, búsqueda y recuperación web, MCP, cron, generación de imágenes, subagentes, memoria de largo plazo, encaminamiento de modelos y una API compatible con OpenAI. Sus canales documentados incluyen Telegram, Discord, Slack, WeChat, correo y Mattermost.

Imagen destacada al estilo cyberpunk que representa un agente personal de IA autoalojado: en el centro, un núcleo robótico nanobot elegante y brillante flota sobre un rack de servidor minimalista, emitiendo flujos de datos neón azules y verdes, conectado a interfaces holográficas flotantes —una ventana de terminal, una interfaz web e iconos de aplicaciones de chat como Telegram, Discord y Slack.

El origen: una alternativa deliberadamente pequeña

GitHub registra la creación del repositorio el 1 de febrero de 2026. La discusión de Hacker News que enlaza directamente al repositorio lo presentó cuatro días más tarde como una alternativa ultraligera a OpenClaw; obtuvo 257 puntos y 128 comentarios.

La propia documentación explica la motivación de diseño: mantener un núcleo legible y añadir memoria, despliegue, automatización, herramientas y canales sin convertirlo en una plataforma monolítica. Esa postura responde a una tensión práctica de los agentes personales: ofrecer conexiones y trabajo persistente sin exigir que cada usuario adopte una pila grande ni una infraestructura ajena.

El proyecto no atribuye públicamente el origen a una sola persona en el README. CONTRIBUTING.md nombra a Re-bin como responsable del proyecto y de las fusiones, y a chengyongru como revisor que puede aprobar solicitudes de cambios.

Filosofía y principios

Ligereza con capacidad suficiente: el núcleo se mantiene pequeño y legible, pero integra los componentes necesarios para operación persistente.

Imagen conceptual al estilo cyberpunk que representa la filosofía de "ligereza con capacidad suficiente": un pequeño cristal geométrico elegante y brillante (el núcleo de nanobot) flota sobre un monolito mecánico masivo, complejo y oscuro que representa plataformas monolíticas, emitiendo una luz neón potente y controlada que corta la oscuridad.

Propiedad de la pila: el usuario puede inspeccionar, personalizar y autoalojar el servicio en lugar de depender de una plataforma cerrada.
Trabajo persistente: objetivos, herramientas, memoria y contexto de chat sobreviven más allá de una conversación puntual.

Representación abstracta de la memoria persistente y el contexto de largo plazo de un agente de IA: una estructura de red neuronal brillante en azul neón alojada dentro de un cubo metálico oscuro y elegante que simboliza un servidor autoalojado, con nodos de datos que pulsan de luz mientras se conectan a través de la red, sobreviviendo más allá de una sola conversación.

Elección de modelo y canal: admite proveedores compatibles con OpenAI, modelos locales, alternativas de respaldo y varios canales de chat.
Claridad al contribuir: la guía pide soluciones pequeñas, claras, desacopladas y duraderas, evitando abstracciones o reformateos innecesarios.

Cómo funciona

La pasarela concentra los canales de entrada, la sesión y el bucle de agente. El modelo decide cuándo invocar una herramienta; la memoria y las habilidades se incorporan como contexto. La WebUI permite separar temas persistentes de chats temporales, inspeccionar llamadas de herramientas, modificaciones de archivos, diferencias y resultados de comandos, y cambiar de modelo o espacio de trabajo desde la conversación.

Panel futurista de WebUI para un agente de IA renderizado en estética cyberpunk de modo oscuro: la interfaz muestra múltiples paneles —un hilo de chat persistente, un visor de diferencias de modificación de archivos con líneas de código rojas y verdes brillantes, y un menú desplegable de selección de modelo— con acentos neón azules y púrpuras.

La versión estable v0.3.0, publicada el 25 de julio de 2026, se denomina «The Agency Release». Sus notas anuncian subagentes en línea, selección de preajustes de modelo por sesión, inicio guiado en la WebUI y aplicación en vivo de cambios de configuración.

Estado oficial y semioficial

nanobot es un proyecto de HKUDS distribuido oficialmente por su repositorio, su documentación nanobot.wiki y el paquete nanobot-ai de PyPI, donde figura la versión 0.3.0 y el comando de instalación.

No se recuperó evidencia de aceptación en un mercado oficial de Anthropic, OpenAI, Cursor u otro proveedor de agentes. Sí hay integración técnica documentada con MCP y una API compatible con OpenAI; eso indica interoperabilidad, no respaldo, certificación ni estatus de estándar por parte de esos proveedores.

El ecosistema

Canales, extensiones y servicios de primera parte

La documentación posiciona a nanobot como punto de integración para MCP, proveedores locales o compatibles con OpenAI, automatizaciones, WebUI, SDK de Python y API compatible con OpenAI. También enlaza guías específicas de proveedores, despliegue, canales de chat, memoria, automatizaciones y herramientas.

Dentro de HKUDS se identificaron proyectos próximos por temática, no dependencias declaradas de nanobot: HKUDS/AutoAgent (marco de agentes sin código), HKUDS/OpenHarness (arnés de agente con asistente personal), HKUDS/ClawTeam (inteligencia de enjambre), HKUDS/AnyTool (capa de uso de herramientas) y HKUDS/LightRAG (generación aumentada por recuperación). La investigación no encontró en sus metadatos una declaración que los convierta en componentes obligatorios de nanobot; deben entenderse como proyectos hermanos del mismo organismo, no como módulos instalados automáticamente.

Bifurcaciones, puertos y herramientas comunitarias

La API de bifurcaciones muestra derivados con una relación explícita en su descripción.

shenmintao/NanoMate (87 estrellas): combina nanobot con SillyTavern y anuncia un modo de acompañante.
YH7916/Interview-Copilot (4 estrellas): se describe como un copiloto de entrevistas basado en nanobot.
KeLuoJun/QuantBot (2 estrellas): adaptación para asistencia financiera cuantitativa.
forzyh/nanobot-zh-annotated (2 estrellas): edición anotada en chino, una forma de localización comunitaria.
luoluocodex/nanobot-ts (sin estrellas en la búsqueda recuperada): se declara migración de nanobot a TypeScript.
SChapelais/NanoRAG-for-Nanobot y chapelaissamuel/NanoRAG-for-Nanobot (sin estrellas en la búsqueda recuperada): se presentan como un RAG sin dependencias inspirado en HKUDS para entornos con restricciones extremas.
Shudh/nanobot-community-docker y orrinwitt/nanobot-docker (sin estrellas en la búsqueda recuperada): imágenes Docker comunitarias no oficiales; la segunda declara incluir utilidades y servidores MCP adicionales.

Estos elementos son bifurcaciones, puertos, documentación o empaquetados de terceros, no extensiones oficiales. La búsqueda también encontró guías chinas de aprendizaje y adaptaciones educativas, lo que confirma actividad comunitaria multilingüe, pero no permitió verificar un catálogo oficial de complementos.

Números del repo

Medición: 11 de agosto de 2026; API de GitHub.

Métrica	Valor
Estrellas	46.859
Bifurcaciones	8.288
Suscriptores reales	205
Lenguaje principal	Python
Licencia	MIT
Creación	1 de febrero de 2026
Última publicación	`v0.3.0`, 25 de julio de 2026
Campo `open_issues_count`	701

Interfaz futurista de repositorio de GitHub en modo oscuro visualizada al estilo cyberpunk: una pantalla holográfica muestra el repositorio "HKUDS/nanobot" con contadores de estrellas y bifurcaciones brillantes en neón (46.859 estrellas, 8.288 forks) pulsando con luz azul eléctrica, sobre un fondo de estructuras de código abstractas y circuitos digitales.

Los contribuidores principales devueltos por la API fueron Re-bin (1.687 contribuciones), chengyongru (801), Athemis (47), axelray-dev (42) y yorkhellen (36).

Hay dos salvedades: watchers_count de la respuesta general replica el número de estrellas, por lo que se informa subscribers_count como suscriptores reales. Además, open_issues_count puede incluir solicitudes de cambios abiertas y no equivale necesariamente a incidencias exclusivamente. La API devolvió updated_at y pushed_at del 12 de agosto de 2026, posteriores a la fecha de esta ejecución; se transcriben como anomalía del metadato de origen, sin interpretar actividad futura.

Cómo contribuir

La contribución está documentada y acepta funcionalidades, correcciones, documentación, pequeños ajustes, refactorizaciones acotadas y cambios de API o configuración cuyo impacto esté explicado. Para cambios grandes o arriesgados pide abrir pronto una incidencia o una solicitud de cambios en borrador.

El flujo indicado es sincronizar el clon, crear una rama temática y ejecutar las comprobaciones locales:

git fetch upstream
git switch main
git pull --ff-only upstream main
git switch -c mi-rama

pip install -e ".[dev]"
pytest
ruff check nanobot/

Para el tipado estricto, la guía especifica uv sync --all-extras --dev, la instalación de dependencias de canales y uv run --no-sync basedpyright. También advierte no mezclar un cambio funcional con reformateos masivos. Las contribuciones se licencian bajo MIT.

Cómo lo recibió la comunidad

La recepción verificable combina interés considerable con dudas sobre complejidad, seguridad y límites funcionales.

El hilo de Hacker News 46897737, enviado por ms7892, enlazó el repositorio directamente y alcanzó 257 puntos y 128 comentarios. En ese hilo, skeledrew valoró que nanobot, inspirado directamente por OpenClaw, reuniera bien componentes que no quería ensamblar y destacó que fuese Python en vez de JavaScript. Es una experiencia individual, no una prueba comparativa.
En el mismo hilo, johaugum delimitó el alcance: distinguió un agente que resuelve una tarea personal, como reunir recibos de correo, de una infraestructura autónoma de planificación, replanificación y ejecución continua de tareas de ingeniería. Es una advertencia útil contra interpretar nanobot como un planificador empresarial general.
halfax lo calificó de «juguete» y de esquema conceptual frente a otro sistema llamado HAL-AI-2. La crítica se atribuye a ese comentarista; no se recuperó una metodología independiente que la valide.
En una discusión de GitHub, la hoja de ruta de Re-bin acumulaba 40 votos y 96 comentarios, mientras que usuarios abrían preguntas sobre permisos de WeCom, Docker, cron, proveedores y errores de modelos. Esto confirma una comunidad de uso y soporte activa, no una valoración uniforme de calidad.

La búsqueda directa en HN recuperó también una publicación inicial de 3 puntos y cero comentarios. No se usa como evidencia de aprobación comunitaria. Las consultas automatizadas a Reddit, X y Product Hunt no produjeron un registro verificable de conversación o lanzamiento atribuible a HKUDS/nanobot; no debe leerse esa limitación de acceso como ausencia de cobertura.

nanobot frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia o límite verificable
OpenClaw	El propio hilo de HN sitúa a nanobot como alternativa inspirada por OpenClaw; ambos pertenecen al espacio de agentes personales con herramientas.	nanobot declara un núcleo Python pequeño y legible; la comparación de líneas de código vista en videos es afirmación de sus autores, no una medición adoptada aquí.
`moltis-org/moltis`	Fue nombrado por `skeledrew` como un puerto Rust relacionado dentro de la conversación sobre alternativas.	No se recuperó su documentación oficial en esta ejecución; por tanto no se afirma una equivalencia técnica.
NanoMate	Bifurcación que declara usar nanobot y SillyTavern para modo de acompañante.	Es una especialización comunitaria, no un reemplazo oficial ni una prueba de compatibilidad completa.

Guía rápida de uso

Instalación y primer arranque

Se requiere Python 3.11 o superior; Git solo es necesario para instalar desde código fuente. Para una instalación estable, el proyecto ofrece estas opciones:

uv tool install nanobot-ai
# o
python -m pip install nanobot-ai

nanobot --version
nanobot webui

Interfaz de terminal cyberpunk visualmente rica que muestra un proceso de instalación de línea de comandos de Python brillante: texto verde y cian neón se desplaza a través de una pantalla holográfica translúcida oscura, mostrando pip install nanobot-ai y nanobot webui en tipografía brillante.

En el primer arranque, nanobot webui crea configuración y espacio de trabajo cuando hacen falta, inicia la pasarela y abre http://127.0.0.1:8765. La WebUI queda ligada a localhost por defecto.

En Settings → Models, se elige proveedor, credencial y modelo. Después se envía Hello! para verificar la conexión.

Si pip muestra externally-managed-environment, la documentación recomienda uv, pipx, el instalador oficial o un entorno virtual. Si el ejecutable no está en PATH, se debe reutilizar el comando de instalación, usar uv tool run --from nanobot-ai nanobot ..., pipx run --spec nanobot-ai nanobot ... o el intérprete del entorno donde se instaló.

Flujos de trabajo habituales

Chat local persistente: ejecutar nanobot webui, configurar el modelo y crear un tema en la WebUI; allí se pueden inspeccionar herramientas, archivos y resultados.
Consulta puntual o automatización de terminal: ejecutar nanobot agent -m "Hello!"; devuelve una respuesta y termina.
Sesión interactiva de terminal: ejecutar nanobot agent; comparte modelo, espacio de trabajo y herramientas configurados, pero no mantiene canales ni automatizaciones tras salir.
Pasarela que permanece activa: tras completar la configuración inicial en primer plano, ejecutar nanobot webui --background. Para operar la pasarela se usan nanobot gateway status, nanobot gateway logs, nanobot gateway restart y nanobot gateway stop.

Configuración esencial

~/.nanobot/config.json: archivo de configuración; los ejemplos de la documentación se fusionan en él, no se sustituyen completos.
Settings → Models: primer lugar para elegir proveedor, credencial y modelo en la WebUI.
Settings → Channels: configuración de aplicaciones de chat como Telegram, Discord, Slack o WeChat.
Apps: acceso desde la WebUI a integraciones de aplicaciones CLI o servidores MCP.
Espacio de trabajo y modo de acceso: se eligen desde el compositor antes de trabajo sobre proyectos.

Trampas frecuentes y soluciones

WebUI abierta sin modelo configurado: es un comportamiento previsto; completar Settings → Models y enviar Hello! antes de diagnosticar herramientas.
Instalación de pip bloqueada por el gestor del sistema: usar uv, pipx o un entorno virtual, en lugar de forzar la instalación global.
El comando nanobot no se encuentra: reutilizar el comando informado por el instalador o ejecutar a través de uv tool run o pipx run.
Fuente instalada en Windows sin poder iniciar npm: entrar en webui, ejecutar npm.cmd install --package-lock=false y npm.cmd run build, volver a la raíz y reintentar la instalación.
Pérdida de conexión en despliegues Docker o permisos de canales: hay discusiones específicas de Docker, WeCom y canales; conviene aislar si el fallo pertenece a instalación, configuración, modelo, pasarela, canal o acceso a herramienta siguiendo la guía de diagnóstico.

Integraciones y migración

nanobot puede conectarse a servidores MCP desde Apps, exponer una API compatible con OpenAI y un SDK de Python, y trabajar con modelos locales mediante Ollama o servidores compatibles con OpenAI como vLLM. El README presenta nanobot gateway como entrada familiar para quien migra desde OpenClaw: evita abrir el navegador y ejecuta la pasarela completa en la terminal. No se recuperó una guía de migración automática ni un importador de configuración desde OpenClaw; la migración documentada es operativa, mediante una pasarela, proveedor y canales configurados de nuevo.

Casos de uso

Personas que quieren un asistente propio pueden mantener conversaciones, memoria y herramientas bajo una instancia local o autoalojada, en vez de depender solo de una interfaz remota.
Equipos pequeños que coordinan trabajo desde chat pueden conectar canales como Telegram, Discord, Slack, correo o WeChat y mantener la misma pasarela, modelo y espacio de trabajo.
Desarrolladores que integran IA en una aplicación existente pueden usar la API compatible con OpenAI, el SDK de Python o MCP para conectar herramientas locales y automatizaciones.
Operadores que necesitan tareas persistentes pueden ejecutar la pasarela en segundo plano, consultar registros y usar automatizaciones programadas; para producción se documentan Docker, Compose y servicios del sistema.
Quienes buscan una alternativa de menor superficie a una pila de agente más grande pueden evaluar su núcleo Python, pero deben validar de forma propia permisos, consumo de tokens, aislamiento y límites del planificador antes de darle acceso a datos o comandos sensibles.

Recursos

Repositorio: https://github.com/HKUDS/nanobot
Documentación oficial: https://nanobot.wiki/docs/latest/getting-started/nanobot-overview
Paquete e instalación: https://pypi.org/project/nanobot-ai/
Configuración y guía de inicio: https://github.com/HKUDS/nanobot/blob/main/docs/configuration.md y https://github.com/HKUDS/nanobot/blob/main/docs/quick-start.md
Contribución: https://github.com/HKUDS/nanobot/blob/main/CONTRIBUTING.md
Lanzamientos y cambios: https://github.com/HKUDS/nanobot/releases
Comunidad/Discord: https://github.com/HKUDS/nanobot/discussions y https://discord.gg/MnCvHqpUGB
Conversación en Hacker News: https://news.ycombinator.com/item?id=46897737

Nota: este artículo combina el repositorio, la documentación oficial, PyPI, discusiones de GitHub, Hacker News y resultados de YouTube consultados el 11 de agosto de 2026. Las métricas cambian con el tiempo.