Usa il tuo modello
Imposta in .env l'endpoint, il modello e la chiave del tuo provider. Il provider ti fattura le chiamate ai modelli, e non ti servono piani, crediti o carte di Comma.
Impostazioni del modelloComma in self-hosting
Esegui Comma su una macchina che gestisci tu. Docker Compose lo compila dal codice open source, e i tuoi dati restano nei tuoi database.
Il primo avvio
Un esempio. In un terminale cloni il repository, copi le impostazioni di esempio e avvii Comma con Docker Compose. Prima parte il passaggio delle impostazioni, poi PostgreSQL, Redis, ClickHouse, MinIO e una casella di posta locale. Poi lo stack crea i bucket di archiviazione e prepara il database, e infine partono il server di Comma e l'app web. Dietro il terminale, un browser su localhost:8080 mostra Comma che chiede il codice di accesso che ha inviato.
Cosa gira sulla tua macchina
Un diagramma di un'istanza self-hosted. Sulla tua macchina, l'app web, Admin, l'API e Salix di Comma girano accanto a PostgreSQL, Redis, ClickHouse, MinIO e a una casella di posta locale. Le chiamate ai modelli escono verso il tuo provider di modelli, le ricerche web verso Exa se aggiungi la sua chiave e, su un'istanza pubblica, i codici di accesso verso il tuo server di posta.
Un unico stack
Docker Compose avvia l'app web, Admin, l'API e Salix di Comma accanto a PostgreSQL, Redis, ClickHouse, MinIO e a una casella di posta locale.
I tuoi dati restano qui
Le tue attività, chat e file vivono in quei database, sulla tua macchina.
Le chiamate vanno dove le mandi tu
Le chiamate ai modelli vanno al tuo provider, la ricerca web a Exa se aggiungi la sua chiave e le email di accesso al tuo server di posta. Lo stack non invia a Comma né dati di analisi né tracce.
Cosa controlli tu
Codice che puoi leggere e modificare
Comma è open source con licenza AGPL-3.0. Leggi il codice, modificalo e crea la tua build. Ogni istanza fornisce il sorgente della propria build.
Vedi su GitHubRendilo disponibile al tuo team
Pubblica l'app web, Admin e l'API ciascuno al proprio indirizzo HTTPS sotto un unico dominio. Aggiungi un vero server di posta per i codici di accesso. La registrazione resta disattivata finché non la attivi.
Accesso pubblicoAggiorna senza perdere dati
Un aggiornamento ricompila il codice e mantiene i cinque volumi che contengono i tuoi dati e le tue chiavi. Prima fai il backup di tutti insieme, poi avvia la release successiva con lo stesso nome di progetto.
Aggiornamenti e backupIn hosting o self-hosted
| comma.surf | Self-hosted | |
|---|---|---|
| Gira su | Server di Comma | Una macchina che gestisci tu |
| I tuoi dati | Archiviati da Comma | Nei tuoi database |
| Modelli | Modelli di Comma, o la tua chiave o il tuo piano | Il tuo provider, o un modello privato per persona |
| Costo | Piani e crediti | La tua macchina e le tue chiamate ai modelli |
| Computer cloud | Uno per ogni workspace | Disattivato di default, richiede Cloudflare |
| Registratore di riunioni | Incluso | Non incluso, personalizzabile |
| Aggiornamenti e backup | Gestiti da Comma | Gestiti da te |
Domande frequenti
Cosa mi serve per eseguirlo?
Docker Engine con Compose v2.24 o successivo, e spazio su disco per la prima build, che scarica le toolchain necessarie. Per chiamate reali ai modelli ti serve anche un account presso un provider di modelli.
Mi serve un account Comma?
No. Lo stack viene compilato dal repository pubblico, senza account Comma né token di accesso. Accedi alla tua istanza con un codice via email.
Quanto costa un'istanza self-hosted?
Comma non la fa pagare, e non richiede piani, crediti o carte. Paghi la macchina su cui gira. Il tuo provider di modelli ti fattura le chiamate ai modelli, ed Exa fattura le ricerche web se aggiungi la sua chiave.
Quali modelli posso usare?
Imposta in .env un modello per tutta l'istanza: il suo endpoint, l'API che usa, l'ID del modello e una chiave. Senza, ogni persona aggiunge un modello privato in Settings dopo l'accesso, e le chiamate usano l'account del provider di quella persona.
Cosa resta fuori dal self-hosting?
Il registratore di riunioni richiede un runtime che il repository non include. I computer cloud sono disattivati di default, e quelli nuovi richiedono una configurazione Cloudflare. Comma può comunque lavorare sul tuo computer, una volta che lo colleghi nelle impostazioni dei dispositivi.
Cosa mi chiede l'AGPL?
Puoi eseguire, studiare e modificare il codice di Comma secondo l'AGPL-3.0. Se offri una versione modificata ad altre persone, mantieni il sorgente a loro disposizione. Ogni istanza fornisce già il sorgente della propria build su /source.tar.gz.