hub
Hub es una capa de automatización autoalojada para ejecutar agentes de Paseo en máquinas locales (laptop, devbox, build server). Conecta servicios externos como GitHub, Linear, Slack y Discord con los daemons de desarrollo.
Ficha actualizada 23 sept 2026, 19:27 · upstream 23 sept 2026, 18:54 · release v0.9.0
Qué es hub
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Paseo Hub es la capa de automatización autoalojada para el ecosistema Paseo. Permite ejecutar agentes de IA directamente en las máquinas donde residen los entornos de desarrollo (laptop, devbox o servidor de compilación), conectando los servicios donde llega el trabajo con los daemons locales.
La arquitectura se basa en Node.js y React, soporta PostgreSQL como base de datos principal o una base embebida para desarrollo local. Dispone de despliegue mediante Docker Compose, configuración vía variables de entorno (.env) y un sistema de triggers programables (cron/diarios). Incluye API pública con contrato OpenAPI 3.1 en /api/openapi.json.
El flujo de trabajo permite definir agentes con opciones específicas por proveedor (codex, etc.), gestión de permisos granular, auditoría completa de eventos y revisiones de configuración en control de versiones. Soporta triggers manuales, conversacionales y programados.
- Automatizar tareas de desarrollo conectando GitHub, Linear o Slack con daemons locales para ejecutar agentes sin exponer código a la nube.
- Ejecutar agentes de IA en servidores de compilación (build server) para tareas pesadas manteniendo el contexto del entorno local.
- Orquestar flujos de trabajo programados que se ejecutan diariamente o en días específicos usando triggers cron locales.
- Gestionar múltiples entornos de desarrollo con una única capa de automatización, auditando cada ejecución y revisión de configuración.
- Integrar Discord para notificaciones y control manual de agentes sin necesidad de exponer endpoints públicos.
- Ejecución local: los agentes corren en las máquinas del usuario (laptop/devbox), no en la nube, preservando el contexto del entorno.
- Configuración versionable: triggers, entornos y permisos se guardan en control de versiones para auditoría y reproducibilidad.
- Soporte multi-proveedor: conecta GitHub, Linear, Slack, Discord con validación nativa por proveedor (codex, etc.).
- API pública completa: contrato OpenAPI 3.1 disponible en /api/openapi.json para integraciones externas.
- Despliegue flexible: soporta PostgreSQL o base de datos embebida, Docker Compose y despliegue one-click básico.
- Seguridad granular: opciones de agente específicas por proveedor con control de permisos y sandboxing.
- Estado temprano: el proyecto está en desarrollo inicial; se esperan cambios rotos (breaking changes) y posibles pérdidas de datos sin aviso previo.
- Dependencia externa: requiere que Paseo esté instalado y corriendo previamente en los daemons locales para funcionar.
- Configuración manual: despliegue de producción necesita configuración explícita de variables de entorno (.env) y URLs HTTPS públicas.
- Portabilidad limitada: las opciones de agente (options) y modos son específicos del proveedor seleccionado y no son portables entre ellos.
- Requisito de Node.js: el desarrollo local y despliegue requieren instalación previa de Node.js y npm.
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.
Para producción, usar PostgreSQL con DATABASE_URL o Docker Compose. Configurar PASEO_HUB_APP_URL con HTTPS público para conectar proveedores externos (GitHub/Slack/Discord). Omitir STRIPE_SECRET_KEY si no se requiere facturación. Para desarrollo local, usar npm run dev con base embebida en $XDG_DATA_HOME/paseo-hub. Validar triggers y permisos antes de despliegue masivo.
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.