Auto-hospedar o Comma

Execute o Comma em uma máquina que você gerencia. O Docker Compose o compila a partir do código aberto, e seus dados ficam nos seus próprios bancos de dados.

A primeira inicialização

Um exemplo. Em um terminal, você clona o repositório, copia as configurações de exemplo e inicia o Comma com o Docker Compose. A etapa de configuração roda primeiro, depois PostgreSQL, Redis, ClickHouse, MinIO e uma caixa de entrada local. Em seguida, o stack cria os buckets de armazenamento e prepara o banco de dados, e o servidor do Comma e o app web iniciam por último. Atrás do terminal, um navegador em localhost:8080 mostra o Comma pedindo o código de login que enviou.

O que roda na sua máquina

Um diagrama de uma instância auto-hospedada. Dentro da sua máquina, o app web, o Admin, a API e o Salix do Comma rodam ao lado do PostgreSQL, Redis, ClickHouse, MinIO e de uma caixa de entrada local. As chamadas de modelo saem para o seu provedor de modelos, as pesquisas na web para o Exa se você adicionar a chave dele e, em uma instância pública, os códigos de login saem pelo seu servidor de e-mail.

Um só stack

O Docker Compose inicia o app web, o Admin, a API e o Salix do Comma ao lado do PostgreSQL, Redis, ClickHouse, MinIO e de uma caixa de entrada local.

Seus dados ficam aqui

Suas tarefas, chats e arquivos ficam nesses bancos de dados, na sua máquina.

As chamadas vão para onde você manda

As chamadas de modelo vão para o seu provedor, a pesquisa na web para o Exa se você adicionar a chave dele, e o e-mail de login para o seu servidor de e-mail. O stack não envia dados de análise nem rastros ao Comma.

O que você controla

Use seu próprio modelo

Defina no .env o endpoint, o modelo e a chave do seu provedor. Seu provedor cobra de você as chamadas de modelo, e você não precisa de plano, créditos nem cartão do Comma.

Configurações do modelo

Código que você pode ler e alterar

O Comma é de código aberto, sob a licença AGPL-3.0. Leia o código, altere-o e compile sua própria versão. Cada instância oferece o código-fonte da própria compilação.

Ver no GitHub

Abra para a sua equipe

Publique o app web, o Admin e a API em endereços HTTPS próprios de um mesmo domínio. Adicione um servidor de e-mail de verdade para os códigos de login. O cadastro fica desativado até você ativá-lo.

Acesso público

Atualize sem perder dados

Uma atualização recompila o código e mantém os cinco volumes que guardam seus dados e chaves. Faça antes o backup de todos juntos e inicie a próxima versão com o mesmo nome de projeto.

Atualizações e backups

Hospedado ou auto-hospedado

comma.surf Auto-hospedado
Roda em Servidores do Comma Uma máquina que você gerencia
Seus dados Guardados pelo Comma Nos seus próprios bancos de dados
Modelos Os modelos do Comma, ou sua própria chave ou plano Seu provedor, ou um modelo privado por pessoa
Custo Planos e créditos Sua máquina e suas chamadas de modelo
Computador na nuvem Um para cada espaço de trabalho Desativado por padrão, exige Cloudflare
Gravador de reuniões Incluído Não incluído, personalizável
Atualizações e backups Feitos pelo Comma Feitos por você

Perguntas frequentes

Do que preciso para rodar?

Docker Engine com Compose v2.24 ou mais recente, e espaço em disco para a primeira compilação, que baixa as ferramentas necessárias. Para chamadas de modelo reais, você também precisa de uma conta em um provedor de modelos.

Preciso de uma conta do Comma?

Não. O stack é compilado a partir do repositório público, sem conta do Comma e sem token de acesso. Você entra na sua própria instância com um código enviado por e-mail.

Quanto custa uma instância auto-hospedada?

O Comma não cobra por ela, e ela não precisa de plano, créditos nem cartão. Você paga pela máquina em que ela roda. Seu provedor de modelos cobra de você as chamadas de modelo, e o Exa cobra as pesquisas na web se você adicionar a chave dele.

Quais modelos posso usar?

Defina um modelo para a instância inteira no .env: o endpoint, a API que ele usa, o ID do modelo e uma chave. Sem isso, cada pessoa adiciona um modelo privado em Settings depois de entrar, e as chamadas usam a conta de provedor dessa pessoa.

O que fica de fora na auto-hospedagem?

O gravador de reuniões precisa de um runtime que o repositório não inclui. Os computadores na nuvem ficam desativados por padrão, e criar novos exige uma configuração do Cloudflare. O Comma ainda pode trabalhar no seu próprio computador depois que você o conectar nas configurações de dispositivos.

O que a AGPL exige de mim?

Sob a AGPL-3.0, você pode executar, estudar e alterar o código do Comma. Se você oferecer uma versão alterada a outras pessoas, mantenha o código-fonte dela disponível para elas. Cada instância já oferece o código-fonte da própria compilação em /source.tar.gz.

Run Comma, Yourself.

Ler o guia