Hermes — Kodama Deployment

O que faz

Gateway de agente IA rodando em VPS, baseado no upstream NousResearch/hermes-agent. O repositório contém apenas o delta específico da Kodama: build do container, patches de runtime e o módulo customizado standup/ — bot de standup diário no Discord com integração ao board.

Stack principal

• Docker / Docker Compose (build e orquestração)
• Python (apply_patches.py, apply_standup_patch.py, módulo standup/)
• Discord (bot de standup)
• GitHub Actions (CI/CD via SSH para o VPS)
• SQLite (standup.db, state.db)

Estrutura relevante

Dockerfile
entrypoint.sh
docker-compose.yml
apply_patches.py          # patches idempotentes no runtime
apply_standup_patch.py
standup/                  # módulo principal customizado

No VPS, o runtime persiste em /home/hermes/hermes-home/ (não versionado):

hermes-home/
  state.db
  auth.json
  cache/
  sessions/
  standup/standup.db

Deploy

Push para main dispara GitHub Action que:

1. SSH no VPS
2. Puxa o repo em /home/hermes-deploy/
3. Rsync dos arquivos fonte para /home/hermes/ (preserva estado)
4. Executa docker compose up -d --build

Comando manual equivalente no VPS:

docker compose up -d --build

Módulo standup (notavel)

Bot Discord com dois horarios fixos (BRT):

• 10:00 — posta pergunta dinamica diaria para o time
• 18:00 — compila respostas e envia resumo ao tech lead

Alem disso, atualiza perfis brain/people/{name}.md no vault Kodama e tem integracao planejada com o kanban em /board.

Observacoes

O upstream do agente e puxado no docker build, entao o repo nao versiona o core — apenas patches e extensoes. Estado de runtime e preservado entre deploys via volume mount do diretorio hermes-home/.