AgentsServer
AgentsServer es el backend ejecutable en máquina local para AgentsDock, que permite ejecutar chats persistentes sin enviar archivos privados a un servicio externo.
Ficha actualizada 23 sept 2026, 5:30 · upstream 23 sept 2026, 5:19 · release v1.0.3
Qué es AgentsServer
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
AgentsServer es el backend de ejecución self-hosted para AgentsDock, una plataforma que ofrece experiencia de chat de escritorio y móvil. El backend se ejecuta en la máquina donde residen los workspaces y las instalaciones del CLI de agentes, proporcionando chats persistentes sin necesidad de enviar archivos privados a un servicio de chat externo.
La aplicación cliente tanto en desktop como en móvil es también open source: ZhengyiLuo/AgentsDock.
## Características principales
- Ejecución de chats de agentes desde desktop y móvil con historial persistente. - Soporte para trabajar con archivos, imágenes, videos, jobs programados y terminales persistentes. - Integración con Claude Code, Codex, Cursor o OpenCode cuando estén disponibles en el servidor. - Ejecución de servidores independientes en la misma máquina. - Pregunta por side questions (interrogaciones) en chats de Codex o Claude. - Compartición de chats interactivos con acceso escópico.
## Instalación y configuración
Se recomienda usar Linux o macOS con arquitectura Apple Silicon. Se requiere `uv` instalado para gestionar el entorno de desarrollo.
Para instalar desde este repositorio:
```bash git clone https://github.com/ZhengyiLuo/AgentsServer.git cd AgentsServer ./install.sh ```
El instalador inicia el servidor por defecto en la puerto 7850 y muestra su URL de acceso y token. Para mostrar el token sin reiniciar:
```bash ./install.sh --show-token ```
Para acceder desde otra red, se puede conectar el servidor y el dispositivo a través de Tailscale. Se deben mantener las tokens privadas y no exponer la port del agente directamente a internet.
## Gestión de memoria
Los nuevos agentes requieren 2 GiB (2048 MiB) de RAM disponible por defecto; los jobs programados requieren 4 GiB (4096 MiB). Este es un check al inicio, no garantiza que cada carga de trabajo se ajuste a la memoria total del sistema.
## Gestión de múltiples servidores
Se puede añadir un servidor adicional sin reemplazar el original:
```bash ./instances.sh new # O elegir nombre y puerto ./instances.sh new --name work --port 7851 ```
Se pueden listar todos los servidores con `./instances.sh list`.
## Actualizaciones
Para el servidor
- Ejecutar chats persistentes con agentes locales sin depender de servicios externos
- Integración de múltiples agentes en una misma máquina para trabajo colaborativo
- Procesamiento de archivos, imágenes y videos mediante agentes especializados
- Automatización de tareas repetitivas con terminales persistentes
- Conexión entre workspaces locales mediante tokens compartidos
- Ejecución de jobs programados con persistencia de contexto
- Soporta múltiples agentes independientes ejecutándose en la misma máquina sin reemplazar el original
- Permite ejecutar servidores con nombres automáticos o personalizados mediante ./instances.sh
- Incluye soporte para preguntas por side-chat (interrogaciones) en Claude Code y otros modelos
- Proporciona historial persistente de chats entre sesiones sin necesidad de reiniciar
- Soporta acceso escópico a chats compartidos mediante tokens de sesión
- Permite ejecutar el backend desde Linux o macOS con arquitectura Apple Silicon
- Requiere al menos 2 GiB de RAM para nuevos agentes por defecto, lo que puede ser un cuello de botella en equipos con recursos limitados
- La persistencia de historial depende del almacenamiento local del sistema operativo y no garantiza durabilidad ante reinicios o actualizaciones
- El soporte para Claude Code, Codex y OpenCode es dependiente de la disponibilidad de estos servicios en el servidor
- No incluye un backend de base de datos persistente por defecto; se requiere configuración adicional con SQLite o PostgreSQL
- La conexión a través de Tailscale no garantiza seguridad si las credenciales son expuestas en logs o configuraciones públicas
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Se recomienda usar Linux como host para aprovechar el soporte nativo de Docker y la gestión de versiones con Git. Para macOS, se puede instalar un contenedor local (Docker Desktop) o usar una máquina virtual con Ubuntu/Debian. Se debe ejecutar `uv` antes de instalar AgentsServer: `curl -LsSf https://astral.sh/uv/install.sh | sh` El servidor se ejecuta por defecto en el puerto 7850. Se puede cambiar mediante la configuración del archivo `.env` o mediante `./instances.sh new --port 7851`. Para ejecutar múltiples agentes, crear un servidor nuevo con `./instances.sh new` y conectarlo desde AgentsDock. Las actualizaciones se realizan ejecutando `git pull --ff-only && ./install.sh`, lo que mantiene el token de acceso intacto. Se recomienda mantener el repositorio sincronizado para recibir las últimas mejoras en la documentación o soporte. Para producción, se
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.