¿Qué es el Aigentron Dev Server?

Un orquestador autoalojado. Una pila de Docker Compose arranca varios agentes de programación, da a cada uno un espacio de trabajo aislado y coordina sus colas de tareas, de modo que una flota de agentes trabaja sobre un repositorio en lugar de una sola sesión de chat.

¿Necesito una clave de API para ejecutarlo?

Sí. Los agentes llaman a un proveedor de modelos, así que debes poner tu propia clave de Anthropic u OpenAI en el archivo .env local. La clave permanece en tu máquina y nunca se envía a arttron.dev.

¿Qué requisitos previos tiene?

Docker Desktop — o Docker Engine con Compose v2 en Linux —, unos 8 GB de disco libre para imágenes y espacios de trabajo, y acceso HTTPS saliente para que los agentes alcancen la API del modelo.

Aigentron Dev Server - servidor propio de agentes de IA

Versión

Instalación local

Instala y arranca el stack con el instalador de una línea, o clona el repositorio y ejecútalo tú mismo.

1. Instalación rápida con install.sh

El instalador descarga la versión etiquetada, compila la imagen en local y arranca el stack; la imagen/perfil la elige el instalador. Volver a ejecutarlo actualiza en el sitio. Para fijar una versión: VERSION=0.1.0 sh install.sh.

curl -fsSL https://raw.githubusercontent.com/Arttron/aigentron/main/install.sh | sh

O clona el código fuente (opcional)

git clone https://github.com/Arttron/aigentron.git
cd aigentron

Requisitos

Docker Desktop, o Docker Engine + Compose v2 (obligatorio)
Opcional: Ollama en ejecución en el host (no en un contenedor) para el nivel de modelo «routine»: solo una opción de proveedor, no un requisito. El orquestador lo alcanza en http://host.docker.internal:11434
ANTHROPIC_API_KEY — necesaria para el nivel de modelo «complex» (Claude en la nube)
Opcional: un modelo compatible con herramientas en tu Ollama del host (por defecto qwen3-coder:30b, definido con ROUTINE_MODEL en .env): solo si eliges Ollama
Opcional: una red Docker que se crea una sola vez para que los agentes lleguen a las bases de datos por nombre de servicio (docker network create lds-agents): solo para el flujo con Compose y agentes
Si usas Ollama, evita qwen2.5-coder: no emite llamadas a herramientas estructuradas y rompe el SDK de agentes. El valor predeterminado admitido es qwen3-coder:30b.

2. Opcional: modelos locales con Ollama

Solo si usas Ollama como proveedor. Descárgalo en tu Ollama del host (no en un contenedor); define ROUTINE_MODEL en .env si eliges otro modelo.

ollama pull qwen3-coder:30b

3. Opcional: red Docker externa

Configuración única, solo necesaria para el flujo con Compose y agentes, para que los agentes lleguen a las bases de datos por nombre de servicio.

docker network create lds-agents

4. Desde el código fuente: compilar y arrancar

Para el checkout del código fuente: equivale a docker compose up -d --build. Levanta Postgres, Redis, LiteLLM (proxy compatible con Anthropic delante de Ollama), el orquestador (:3001) y el panel (:3000), todo con bind-mount para recarga en caliente. El primer arranque tarda más, porque el orquestador compila packages/shared y packages/agent-runner antes de que pase el healthcheck.

make up

5. Abrir el panel

Panel → http://localhost:3000 • API del orquestador → http://localhost:3001 Los valores por defecto se muestran arriba; el puerto del panel puede variar según la configuración: cámbialo mediante la asignación de puertos (compose o docker run -p). Opcional: docker compose --profile mcp up -d para Playwright MCP y un servidor de desarrollo para agentes de frontend y diseño.

Comandos útiles: make logs | make ps | make migrate | make down | make clean (⚠️ borra los datos de la base de datos). En el repositorio encontrarás documentación más detallada sobre configuración, enrutado de modelos y puerta de aprobación.

Volver al inicio