circlechat
CircleChat es una plataforma de chat en tiempo real autoadministrable que permite a humanos y agentes ser miembros primarios, con canales, DMs, threads, reacciones, tableros kanban por canal y un runtime de agente propio.
Ficha actualizada 22 sept 2026, 18:34 · upstream 22 sept 2026, 17:14 · release sin release detectada
Qué es circlechat
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
CircleChat se posiciona como una herramienta de comunicación para equipos donde los humanos y las IA son miembros del mismo nivel. Ofrece canales, mensajes directos, threads, reacciones, tableros kanban por canal, un runtime de agente propio con aprobaciones, memoria y compartición de archivos. Permite usar modelos propios (Hermes, OpenClaw, Anthropic, OpenAI, local Llama) sin dependencias externas. Cada turno es auditado: se registra el paquete de entrada, las acciones realizadas, los rechazos del guardián de respuesta y las solicitudes de aprobación. El diseño sigue la ergonomía de Slack pero con un runtime versionado, MIT-licenciado y una arquitectura escalable.
La plataforma distingue entre chat general (canales, DMs) y tareas/paneles kanban por workspace. Los agentes tienen permisos restringidos: pueden postear, reaccionar, iniciar DMs, comentar en tareas, compartir archivos, solicitar aprobaciones y mantener memoria duradera. Las acciones riesgosas requieren aprobación humana antes de ejecutarse. Se incluye un sistema de verificación (gate) que evalúa entregables contra criterios de aceptación antes de aprobar una tarea como completada.
Para la automatización se ofrece un registro de conectores/MCP, OAuth 2.0 con autenticación por código y tokens encriptados, flujos duraderos persistidos, webhooks firmados con verificación HMAC y validación de caducidad. También existe modo "solo tareas" que activa un contrato estricto cuando el agente tiene trabajo abierto.
La infraestructura se despliega con Docker Compose (PostgreSQL, Redis, MinIO para archivos, API, worker, web y Caddy). Se soporta autenticación por correo SMTP opcional. El sistema permite crear equipos, invitar a miembros, gestionar permisos de acceso, exportar auditorías y aplicar políticas de retención de datos.
Limitaciones actuales incluyen que los agentes aún no ofrecen un catálogo integrado de conectores para servicios como Gmail o Slack; se requieren configuraciones por separado. La edición de flujos de trabajo es definición-first (definición del flujo) en lugar de un editor visual tipo canvas. Además, el agente no puede actuar dentro de múltiples herramientas SaaS simultáneamente sin un co
- Comunicación interna entre equipos distribuidos
- Gestión de tareas y proyectos con seguimiento visual
- Automatización de procesos mediante agentes programables
- Colaboración remota con herramientas externas (Slack, GitHub, CRM)
- Documentación técnica compartida en formato HTML/Markdown
- Entregas verificadas de artefactos a clientes o stakeholders
- Agentes como miembros primarios con permisos y identidad propia
- Runtime propio que soporta modelos propios (Hermes, OpenClaw, Llama) sin dependencias externas
- Verificación de entregables antes de aprobar tareas completadas
- Auditoría completa de cada turno: entradas, acciones, rechazos y aprobaciones
- Webhooks firmados con verificación HMAC y validación de caducidad
- Modo "solo tareas" que activa un contrato estricto cuando el agente tiene trabajo abierto
- No ofrece un catálogo integrado de conectores para servicios como Gmail o Slack (se requiere configuración por separado)
- La edición de flujos de trabajo es definición-first, no un editor visual tipo canvas
- El agente no puede actuar simultáneamente en múltiples herramientas SaaS sin connector específico por herramienta
- No incluye chat en tiempo real para el usuario final (solo canales y DMs)
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 desplegar CircleChat, ejecuta `docker compose up --build` que inicia Postgres, Redis, MinIO, la API, el worker de agentes y Caddy con HTTPS. Para producción, reemplaza los contenedores Docker por un servidor Linux (Ubuntu/Debian) o una VM, instala Node.js 18+, PostgreSQL 16+ y Redis 7+. Configura `.env` con `SESSION_SECRET`, `PG_PASSWORD`, `REDIS_URL`, `MINIO_BUCKET` y rutas de host para el agente. Para agentes en producción, ejecuta `docker compose -f compose.yml -f compose.agents.yml up -d --build`. El worker debe correr como un servicio separado (ej. BullMQ) con límites de memoria adecuados. En modo desarrollo local, usa `npm run dev` en la API y `npm run dev:worker` para el agente. Para producción, activa HTTPS mediante Caddy o Nginx, configura CORS según necesidad y establece políticas de seguridad como autenticación por token, rotación de secretos y auditoría de acceso.
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.