Standalone (autoalojado)

El modo Standalone ejecuta ADHDev por completo en una sola máquina. Agrupa el panel local, la API HTTP/WebSocket local y el runtime de session-host en un único proceso — sin cuenta, sin conexión a la nube, sin P2P, sin TURN.

Es la superficie de código abierto AGPL-3.0 de ADHDev, publicada como @adhdev/daemon-standalone.

Cuándo usarlo

Standalone es la elección correcta cuando todo lo que quieres controlar está en la máquina que tienes delante — o en una máquina que puedes alcanzar directamente a través de tu propia LAN.

No es un reemplazo autoalojado del panel de la nube. Standalone deliberadamente no incluye:

• Notificaciones push — sin notificaciones de aprobación, finalización o desconexión a tu teléfono
• Acceso remoto a través de internet — no hay servidor de señalización, por lo que no hay conexión desde fuera de tu red
• Flotas multimáquina — un servidor standalone gestiona únicamente su propia máquina

Esas son funciones de la nube. Si las quieres, consulta Primeros pasos para el daemon de la nube.

Iniciarlo

npm install -g adhdev
adhdev standalone

adhdev standalone es un envoltorio ligero: resuelve y lanza el paquete @adhdev/daemon-standalone, correspondiente al canal de npm del que vino tu CLI. También puedes ejecutar el paquete OSS directamente:

npm install -g @adhdev/daemon-standalone
adhdev-standalone

O sin instalar nada globalmente:

npx @adhdev/daemon-standalone

Luego abre http://localhost:3847.

Lo que debería suceder: el panel se carga y muestra tu máquina local. No hay pantalla de inicio de sesión — standalone no tiene cuentas.

TIP

Las rutas de instalación probadas públicamente son macOS y Windows. Linux puede funcionar para standalone, pero no se ha validado lo suficiente para presentarse como una ruta compatible.

Puertos y binding

El servidor standalone sirve el panel y la API HTTP/WebSocket desde un solo puerto, 3847 por defecto, vinculado a 127.0.0.1 (solo loopback).

adhdev standalone --port 4000

Acceso LAN

Para alcanzar el panel desde otro dispositivo de tu red, vincula una dirección distinta de loopback:

adhdev standalone --host 0.0.0.0 --token <some-secret>

--host toma una dirección explícita — una dirección IPv4, una dirección IPv6, o localhost. No hay forma booleana: un --host sin valor, o un valor no reconocido, es un fallo de arranque visible en lugar de un binding silencioso que no pediste.

WARNING

--host 0.0.0.0 (o la dirección IPv6 any-address ::) vincula todas las interfaces. Standalone no tiene autenticación por defecto, así que cualquiera que pueda alcanzar el puerto obtiene control total de tus agentes. Empareja siempre un binding público con --token. El servidor imprime una advertencia al arrancar cuando vinculas públicamente sin autenticación.

--token exige ese token antes de que el panel se conecte. Este es el único mecanismo de autenticación que tiene standalone.

Flags

Flag	Propósito
--port, -p <port>	Puerto para el servidor HTTP/WS (por defecto 3847)
--host, -H <address>	Dirección de binding explícita — IPv4, IPv6, o localhost (por defecto 127.0.0.1)
--token <token>	Exige este token para usar el panel
--dev	Habilita DevConsole para escribir y probar scripts de proveedor
--public <path>	Ruta personalizada a la distribución del panel
--no-open	No abrir el navegador al arrancar
--help, -h	Muestra el uso

Qué funciona en standalone

Una vez que el panel está levantado, la superficie de agentes locales se comporta igual que en modo nube:

• Detección y lanzamiento de agentes CLI y agentes ACP
• Leer el chat, enviar mensajes y responder prompts de aprobación desde el panel
• Listado de sesiones, cambio entre ellas y la vista de terminal
• El servidor MCP en modo local, que habla con http://localhost:3847

Standalone vs nube

	Standalone	Cloud
Cuenta requerida	No	Sí
Transporte	HTTP/WS directo en tu máquina	P2P WebRTC, con TURN para NAT bloqueados
Alcanzable desde internet	No	Sí
Máquinas por panel	Una	Depende del plan
Notificaciones push	No	Sí
Autenticación	--token opcional	OAuth, claves de API, secretos de máquina
Licencia	AGPL-3.0	Propietaria

Configuración más profunda

El repositorio OSS contiene la documentación de referencia sobre los internos de standalone — autenticación por contraseña, valores de host guardados por defecto, ubicaciones de los archivos de configuración local, la superficie de la API local y el runtime de session-host:

• Self-hosted Setup
• Configuration
• Local API
• Session Host