Gugu-web
Plataforma Agent UI unificada con gestión de proyectos, calendario, notas y archivos. Soporta integración con QQ/WeChat/Feishu, ejecución de shell aislado y observabilidad LoopScope.
Ficha actualizada 26 sept 2026, 13:20 · upstream 26 sept 2026, 12:50 · release v1.3.2
Qué es Gugu-web
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Gugu-web es una plataforma de interfaz para agentes que centraliza el flujo de trabajo en un espacio único, integrando gestión de proyectos (kanban), calendario, notas, archivos y lienzo infinito. El sistema permite a los usuarios interactuar con agentes mediante múltiples canales como web, QQ, WeChat o Feishu, manteniendo el contexto compartido entre sesiones.
La arquitectura incluye un runtime para la ejecución de herramientas y skills personalizados, un motor de búsqueda híbrido (SearXNG + RAG), y un sistema de memoria a largo plazo que recuerda preferencias del usuario. El frontend está construido con Vue 3 y el backend en Python, comunicándose vía API REST/GraphQL.
El proyecto destaca por su enfoque en la observabilidad mediante LoopScope, que permite diagnosticar el ciclo de vida del agente (token usage, tool calls, cache). Soporta despliegue autocontenido con Docker Compose, incluyendo servicios para PostgreSQL, Redis y sandbox de ejecución segura.
- Gestión integral de proyectos: crear tareas, organizar en kanban, establecer fechas límite y visualizar progreso en calendario.
- Asistente personal conectado a mensajería: recibir notificaciones y dar instrucciones vía QQ/WeChat/Feishu sin salir del flujo de trabajo.
- Búsqueda híbrida local y web: consultar documentos internos y realizar búsquedas en internet simultáneamente con RAG.
- Ejecución segura de scripts: ejecutar comandos Shell en entorno aislado para automatizar tareas repetitivas o generar reportes.
- Integración nativa con canales de mensajería (QQ, WeChat, Feishu) que soporta flujos de trabajo multiusuario y grupos.
- Observabilidad completa mediante LoopScope para monitorear el ciclo del agente, uso de tokens y llamadas a herramientas.
- Arquitectura de contexto optimizada que separa reglas estables de datos dinámicos, mejorando la eficiencia en LLM.
- Sandbox de ejecución Shell con límites de recursos y red controlada para operaciones automatizadas seguras.
- Dependencia de API keys externas (BYOK) para modelos LLM; no incluye backend propio de inferencia.
- Requiere configuración inicial de variables de entorno (.env) para autenticación y conexión a servicios externos.
- El sandbox por defecto usa Docker rootful; en producción se recomienda forzar rootless con GUGU_SANDBOX_ROOTLESS_REQUIRED=true.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliegue recomendado: usar docker compose up -d desde el repositorio raíz. Configurar GUGU_DB_PASSWORD y ADMIN_PASSWORD en .env. Para despliegues online, establecer GUGU_PUBLIC_APP_URL con la URL completa del dominio. En entornos offline, importar gugu-compose-bundle.tar y usar docker-compose.offline.yml. Asegurar que PostgreSQL, Redis y SearXNG estén accesibles desde el contenedor.
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.