Documentazione

Tutto ciò che ti serve per spedire

Sfoglia la documentazione di Simmetric Chat - dal tuo primo prompt ai deployment in produzione.

Pipeline DLP per i documenti — guida operatore

Quando la scansione DLP è abilitata per un workspace, ogni documento caricato attraversa una scansione asincrona pg-boss dopo l'ingest:

Wiki knowledge engine — archivi con schema, wikilink e synth

Il wiki engine dà a ogni archivio tre livelli di istruzione: regole hard enforce dal codice, uno schema prompt per-archivio (linee guida editoriali advisory) e campi strutturati (persona, purpose, scope). Modello mentale: lo schemaPrompt sta al wiki come…

Connettori — canali esterni connessi al knowledge base

I connettori collegano i canali di messaggistica dove si trovano già i vostri clienti e colleghi — WhatsApp, Telegram, Discord, Slack — alla stessa knowledge base che alimenta il chat interno. Le conversazioni restano sui vostri server: l'app interroga l…

Quotas e costi — limiti d'uso e di spesa

Il motore di quota copre tre generi: quota token e quota storage (Phase 207) più la quota costo (Phase 216, hold-and-settle sulla matematica del denaro reale). Le quote sono lo strumento di operatore per i tetti d'uso su installazioni multi-utente; vinco…

Pipeline di sintesi — riunire i documenti, scoprire le contraddizioni

La pipeline di sintesi multi-documento prende un insieme di pagine/documenti di un archivio e produce pagine wiki riunite: ogni pagina sintetizza le fonti, segnala dove le fonti non sono d'accordo (contradiction detection), rispetta i budget di token/chi…

Custom skills — istruzioni personalizzate richiamabili con `/slug`

Una skill personalizzata è un template di prompt che un operatore o un utente compona una volta e richiama all'infinito dalla chat come comando slash (/translate Ciao mondo). Le skill sono solo modalitá prompt-template: l'invocazione compila il template …

Guida introduttiva

Simmetric Chat è una piattaforma di chat AI local-first e air-gap capable: funziona senza connessione a servizi cloud esterni, con LLM locale (Ollama), embedding locale (Xenova) e vector DB locale (LanceDB). Può però usare provider cloud (OpenAI, Anthrop…

Architettura

Simmetric Chat è un monorepo TypeScript modulare con 5 package più un'app desktop Tauri. Il principio guida è la separazione dei confini: ogni package ha responsabilità distinte e comunica con gli altri solo tramite interfacce ben definite (HTTP o il pac…

Configurazione

Simmetric Chat ha due livelli di configurazione: variabili d'ambiente validate con Zod all'avvio del processo, e un layer di runtime config su DB che gli admin modificano da UI senza riavviare alcun servizio.

Riferimento API

API REST del server Express (porta 3000, prefisso /api), con Swagger UI su /api-docs e spec OpenAPI su /api-docs/json generata dalle annotazioni @openapi JSDoc.

Guida alle funzionalità

Guida alle feature con internals, flusso dati e riferimenti file:line. Per ogni feature: come funziona, come si usa, come si estende.

Integrazione del widget

Il widget embeddabile è un servizio separato (packages/widget, porta 3211) che espone una chat AI sul tuo sito. Architettura: Express + Preact IIFE in iframe sandboxed, proxy SSE trasparente verso il server, sessioni anonime, lead capture, branding per-s…

MCP Marketplace

Il MCP Marketplace permette di installare, abilitare e scoping MCP server esterni da un catalogo curato. Gli MCP server espongono tool che l'agente ReAct può invocare durante le chat, estendendo le capacità senza codice.

Amministrazione

Guida operativa per amministratori: utenti, ruoli (RBAC), workspace, audit, licenze e backup amministrativi. Tutte le operazioni richiedono authMiddleware più permessi specifici - vedi la API Reference per l'inventario completo degli endpoint.

Deployment

Simmetric Chat è air-gap capable e local-first. Cinque target di deployment: Docker Compose multi-container (raccomandata per produzione), container singolo all-in-one (ambienti air-gapped), stack gestito Coolify, override dev (hot-reload su Docker) e de…

Swagger / OpenAPI 3.0 sono serviti su /api-docs quando il server è in esecuzione.