Documentación

Todo lo que necesitas para enviar

Explora la documentación de Simmetric Chat - desde tu primer prompt hasta los despliegues en producción.

Cuotas y costes — los topes de uso y de gasto

El motor de cuota cubre tres géneros: la cuota de tokens y la cuota de almacenamiento (Phase 207) más la cuota de coste (Phase 216, hold-and-settle sobre la matemática del dinero real). Las cuotas son la herramienta del operador para los topes de uso en …

Conectores — canales externos conectados a la base de conocimiento

Los conectores vinculen los canales de mensajería donde ya se encuentran sus clientes y colegas — WhatsApp, Telegram, Discord, Slack — con la misma base de conocimiento que alimenta el chat interno. Las conversaciones permanecen en sus servidores: la apl…

Motor de wiki — archivos con esquema, wikilinks y síntesis

El motor de wiki da a cada archivo un modelo de instrucción de tres niveles: reglas duras aplicadas por el código, un prompt de esquema por archivo (directrices editoriales advisory) y campos estructurados (persona, purpose, scope). Modelo mental: schema…

Skills personalizadas — instrucciones a medida invocables con `/slug`

Una skill personalizada es una plantilla de prompt que un operador o un usuario compone una vez e invoca sin límite desde el chat como comando slash (/translate Hola mundo). Las skills son solo capacidad de plantilla-de-prompt: la invocación compila la p…

Pipeline DLP para documentos — referencia operativa

Cuando el escaneo DLP está habilitado para un workspace, cada documento cargado atraviesa un escaneo asíncrono pg-boss tras la ingesta:

Pipeline de síntesis — reunir los documentos, descubrir las contradicciones

La pipeline de síntesis multi-documento toma un conjunto de páginas/documentos de un archivo y produce páginas wiki reunidas: cada página sintetiza las fuentes, señala dónde las fuentes no están de acuerdo (contradiction detection), respeta los presupues…

Guía de inicio

Simmetric Chat es una plataforma de chat IA local-first y capaz de funcionar sin conexión (air-gap): funciona sin conexión a servicios cloud externos, con LLM local (Ollama), embeddings locales (Xenova) y base vectorial local (LanceDB). Sin embargo, pued…

Arquitectura

Simmetric Chat es un monorepo TypeScript modular con 5 packages más una app de escritorio Tauri. El principio rector es la separación de fronteras: cada package tiene responsabilidades distintas y se comunica con los demás solo mediante interfaces bien d…

Configuración

Simmetric Chat tiene dos niveles de configuración: variables de entorno validadas con Zod en el arranque del proceso, y una capa de configuración runtime almacenada en la base de datos que los administradores pueden editar desde la interfaz sin reiniciar…

Referencia de API

API REST del servidor Express (puerto 3000, prefijo /api), con una interfaz Swagger interactiva y una spec OpenAPI servida por el propio servidor, documentada aquí por dominio con sus mecanismos de autenticación, límites de velocidad y convenciones de re…

Guía de funcionalidades

Guía de las features con internals, flujo de datos y referencias file:line. Para cada feature: cómo funciona, cómo se usa, cómo se extiende.

Integración del widget

El widget embebible es un servicio separado (packages/widget, puerto 3211) que expone un chat AI en tu sitio. Arquitectura: Express + Preact IIFE en iframe sandboxed, proxy SSE transparente hacia el servidor, sesiones anónimas, lead capture, branding por…

MCP Marketplace

El MCP Marketplace permite instalar, habilitar y scopear MCP server externos desde un catálogo curado. Los MCP server exponen tools que el agente ReAct puede invocar durante los chats, extendiendo las capacidades sin código.

Administración

Guía operativa para administradores: usuarios, roles (RBAC), workspace, audit, licencias y backups administrativos. Todas las operaciones requieren authMiddleware más permisos específicos - ver la API Reference para el inventario completo de endpoints.

Deployment

Simmetric Chat es air-gap capable y local-first. Cinco targets de deployment: Docker Compose multi-container (recomendada para producción), container único all-in-one (entornos air-gapped), stack gestionado Coolify, override dev (hot-reload sobre Docker)…

Desarrollo

Guía para contribuir al codebase: setup, estructura monorepo, scripts, convenciones, i18n.

Testing

Simmetric Chat usa Jest 30 con transformación @swc/jest (unit + integration) y Playwright (E2E), orquestados por Turborepo. El jest.config.cjs raíz agrega los 5 proyectos (shared, server, frontend, collector, widget).

Troubleshooting

Síntomas comunes, causa, resolución. Referencias file:line y cross-link a los docs.

Documentación API interactiva

Swagger / OpenAPI 3.0 se sirven en /api-docs cuando el servidor está en ejecución.