Guia de Recuperação do ZimBot 🆘

⚠️ Guarde este documento offline — é sua única rota de volta se tudo cair.

Pré-requisitos

  • Frase-senha mestra (só você sabe, NUNCA armazenada em lugar nenhum)
  • Repositório GitHub: RafAdmin/hermes-brain
  • Máquina Linux com GPG instalado (sudo apt install gnupg)

Passo a Passo da Recuperação

1. Clone o repositório

git clone git@github.com:RafAdmin/hermes-brain.git
cd hermes-brain

2. Descriptografe os segredos

Execute o script de recuperação (já está no repositório):

chmod +x secrets/recuperar.sh
./secrets/recuperar.sh

Ou manualmente com GPG:

# Oracle ZimBot (default)
gpg --decrypt --output ~/.hermes/.env secrets/env-oracle-zimbot.gpg
 
# Light ZimBot (light)
gpg --decrypt --output ~/.hermes/profiles/light/.env secrets/env-light-zimbot.gpg

O GPG vai pedir sua frase-senha mestra. Digite-a exatamente como criou.

3. Reinstale o Hermes

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/setup.sh | bash

4. Restaure a configuração

# Copie o config.yaml base
cp Default/Config/config-default.yaml ~/.hermes/config.yaml
 
# Copie o config do light
cp Default/Config/config-light.yaml ~/.hermes/profiles/light/config.yaml

5. Recupere Memória e SOUL

cp Default/Config/persona_zimbot.md ~/.hermes/SOUL.md
# A memória (memories) é restaurada pelo Hermes automaticamente ao iniciar

6. Inicie os gateways

hermes gateway install
hermes --profile light gateway install
systemctl --user start hermes-gateway hermes-gateway-light

Estrutura do Vault

hermes-brain/
├── Default/Config/         ← Documentação de configuração
│   ├── guia-recuperacao-zimbot.md  ← Este documento
│   ├── persona_zimbot.md           ← SOUL do ZimBot
│   ├── mcp_servers.md              ← MCPs configurados
│   ├── skills_customizadas.md      ← Skills instaladas
│   ├── apis_configuradas.md        ← APIs e integrações
│   ├── otimizacoes_hermes.md       ← Otimizações e modelos
│   ├── config-default.yaml         ← Backup do config.yaml
│   └── config-light.yaml           ← Backup do config do light
├── secrets/                ← 🔐 CRIPTOGRAFADO
│   ├── env-oracle-zimbot.gpg       ← .env do bot principal
│   ├── env-light-zimbot.gpg        ← .env do bot light
│   └── recuperar.sh                 ← Script de descriptografia
├── BMAD/                   ← Documentação do método BMAD
├── Knowledge/              ← Base de conhecimento
└── Infra/                  ← Infraestrutura e servidores

Verificação pós-recuperação

Após restaurar, confirme que está tudo funcionando:

hermes gateway status
hermes --profile light gateway status

Contatos de emergência

  • GitHub: RafAdmin (dono do repo hermes-brain)
  • Provedor OpenCode Go: opencode.ai (assinatura $10/mês)
  • Telegram BotFather: @BotFather (se precisar recriar tokens)

🔄 Atualizado automaticamente pelo heartbeat do ZimBot a cada 6h. Última atualização: 2026-06-16