Qué es
Nanobot es un agente de inteligencia artificial diseñado para la terminal, creado por HKUDS. No es un chat decorativo: trabaja dentro de tu workspace, lee y modifica archivos, ejecuta herramientas y resuelve tareas reales de código.
Se instala como un paquete de Python y se usa como cualquier comando de tu shell:
pip install nanobotLos comandos
Un solo binario, varios modos según lo que necesites:
| Comando | Qué hace |
|---|---|
nanobot onboard | Primer uso: configura el modelo, el workspace y crea ~/.nanobot/config.json |
nanobot agent | El agente interactivo: charlás con él y ejecuta tareas en tu workspace |
nanobot gateway | Conecta al mismo agente desde otros clientes (los gateway se sincronizan) |
nanobot serve | Levanta una API compatible con OpenAI: cualquier app puede usar tu agente |
nanobot webui | Interfaz web con workbench visual para armar y probar flujos |
Cómo trabaja el agente
La gracia está en la arquitectura de flujo de herramientas. El agente no “responde” y listo: puede tomar una serie de acciones encadenadas para cumplir un objetivo:
objetivo → plan → ejecutar herramientas → leer resultados → ajustar → entregarPor ejemplo: “refactorizá este módulo y actualizá los tests” termina siendo una secuencia real de ediciones sobre tu código, no un texto que te sugiere qué hacer.
Manejo de archivos
Puede operar sobre múltiples archivos a la vez, con edición precisa en línea y una política de seguridad para que no toque lo que no corresponde. Se configura qué path puede modificar y qué acciones están permitidas.
Ejecución de comandos
Puede correr comandos dentro del workspace, leer su salida y aprender del resultado para el siguiente paso. Eso es lo que lo convierte en un agente de verdad y no en un autocompletado glorioso.
Configuración
Todo vive en ~/.nanobot/config.json:
{ "provider": "openrouter", "model": "qwen2.5-coder-32b", "workspace": "/ruta/a/tu/proyecto"}Un archivo, sin humo. Si cambiás de proveedor o de modelo, editás eso y listo.
La API compatible con OpenAI
Con nanobot serve obtenés un endpoint local estilo OpenAI (/v1/chat/completions). Eso significa que cualquier herramienta que hable OpenAI puede apuntar a tu agente: IDEs, scripts, herramientas de terceros, autos, todo.
tu_app → localhost:8080/v1/chat/completions → nanobot → tu workspacePor qué me gusta
- Cero fricción: una pip install y estás operando.
- Transparente: ves todo lo que hace; no es una caja negra en la nube.
- Está en tu máquina: tus archivos, tu workspace, tus reglas.
- Un solo binario cubre agente, API y UI.
Siguiente paso
Instalarlo y dejarlo trabajar en un repo chico de verdad: que refactorice, corra los tests y te muestre el diff. Ahí se siente la diferencia entre “chatear con IA” y “trabajar con un agente”.
Repo: github.com/HKUDS/nanobot