Standalone (autoalojado)

El modo Standalone ejecuta ADHDev sin cuenta, en una máquina que controlas. 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 vinculadas a una cuenta y máquinas fuera de tu red — las máquinas standalone pueden emparejarse si se alcanzan directamente (misma red o Tailscale), pero no hay relé en la nube

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 del panel que tiene standalone.

Emparejar otra máquina en un mesh que aloja este daemon necesita el mismo tipo de dirección: enlaza 0.0.0.0 o una IP de LAN/Tailscale, no el loopback por defecto. Los pares de mesh no usan el token del panel; cada uno se autentica con su propio secreto de emparejamiento. Consulta Multimáquina.

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
• 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