Repolode
AFK-surf

AFK-surf/Comma

Agente de IA pessoal, open source e sem sessões, que transforma objetivos em Tasks e continua trabalhando nelas em vários dispositivos, com opção de hospedagem própria via Docker Compose.

Estrelas
329
Forks
22
Issues abertas
1
Último commit
anteontem

O que é?

Comma é um agente de IA pessoal que organiza o trabalho em torno de Tasks persistentes, em vez de sessões de chat. Uma pergunta rápida recebe resposta no chat, enquanto pedidos maiores viram Tasks que o agente planeja, executa, revisa e verifica até concluir o objetivo. As Tasks passam pelos estados In progress, Needs Review e Done, e decisões que dependem do usuário ficam em Needs Review.

O agente pode executar monitoramentos recorrentes chamados Loops, que acompanham uma caixa de entrada, um repositório ou um feed e só acionam o modelo quando algo precisa de atenção. Em um Mac, o componente Salix pode ler arquivos locais e, quando habilitado, alterá-los, executar comandos ou delegar trabalho a ferramentas como Codex e Claude Code. O acesso aos modelos usa sua própria API key ou um plano do ChatGPT ou Claude.

O backend é escrito principalmente em Elixir/OTP, com cada agente executado como um processo próprio, e o repositório inclui modelos TLA+ e propriedades de runtime verificadas com Lean. O serviço hospedado está em comma.surf, e o repositório inclui uma configuração do Docker Compose para executar uma instância de nó único com PostgreSQL, Redis, MinIO e ClickHouse.

Recursos principais

  • 01Transforma pedidos maiores em Tasks que são planejadas, executadas e verificadas até serem concluídas.
  • 02Executa Loops que monitoram caixas de entrada, repositórios ou feeds e acionam o agente apenas quando necessário.
  • 03Conecta um Mac pelo Salix para ler arquivos locais e, com permissão, executar comandos.
  • 04Pode acionar Codex, Claude Code e outros agentes como Workers ou Sub-agents.
  • 05Oferece uma configuração do Docker Compose para hospedagem própria com PostgreSQL, Redis e MinIO.

Casos de uso

  • Delegar tarefas pessoais ou profissionais com várias etapas que devem continuar em diferentes dispositivos.
  • Monitorar uma caixa de entrada ou um repositório e fazer com que o agente aja apenas quando algo mudar.
  • Executar um agente pessoal hospedado por você que use a chave do seu próprio provedor de modelos.
  • Orquestrar agentes de programação já existentes, como Claude Code, em um único quadro de tarefas.

Início rápido

  1. 1

    Copie a configuração de exemplo

    cp .env.example .env
  2. 2

    Defina COMMA_OWNER_EMAIL e seu provedor de modelos em .env

  3. 3

    Compile e inicie a stack do Docker Compose

    docker compose up -d --build
  4. 4

    Acesse http://localhost:8080, solicite um código de login e consulte-o em http://localhost:8025

Antes de usar

  • A hospedagem própria requer Docker Compose v2.24 ou posterior e uma conta de provedor de modelos para chamadas reais.
  • A stack padrão não inclui um modelo simulado, então chamadas reais podem gerar cobranças do provedor.
  • A licença AGPL-3.0 exige que o código-fonte continue disponível se você disponibilizar uma versão modificada.
  • Alguns recursos, como os computadores em nuvem do Group e os hosts VMM do Agent, precisam de runtimes extras que este repositório não inclui.

Em coleções

Tópicos

Perguntas frequentes

O que é Comma?
Agente de IA pessoal, open source e sem sessões, que transforma objetivos em Tasks e continua trabalhando nelas em vários dispositivos, com opção de hospedagem própria via Docker Compose. Comma é um agente de IA pessoal que organiza o trabalho em torno de Tasks persistentes, em vez de sessões de chat. Uma pergunta rápida recebe resposta no chat, enquanto pedidos maiores viram Tasks que o agente planeja, executa, revisa e verifica até concluir o objetivo. As Tasks passam pelos estados In progress, Needs Review e Done, e decisões que dependem do usuário ficam em Needs Review.
Comma é gratuito? Qual é a licença?
Comma é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Comma ainda é mantido?
Manutenção ativa. O último commit de Comma foi em 20 de out. de 2026.
Para que posso usar Comma?
Delegar tarefas pessoais ou profissionais com várias etapas que devem continuar em diferentes dispositivos. Monitorar uma caixa de entrada ou um repositório e fazer com que o agente aja apenas quando algo mudar. Executar um agente pessoal hospedado por você que use a chave do seu próprio provedor de modelos. Orquestrar agentes de programação já existentes, como Claude Code, em um único quadro de tarefas.
Como instalar Comma?
Copie a configuração de exemplo: cp .env.example .env Defina COMMA_OWNER_EMAIL e seu provedor de modelos em .env Compile e inicie a stack do Docker Compose: docker compose up -d --build Acesse http://localhost:8080, solicite um código de login e consulte-o em http://localhost:8025
Onde consigo Comma?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AFK-surf/Comma

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados