A Vertra Cloud não hospeda modelo. Você traz a chave de um provedor, e o uso do modelo é cobrado de você por esse provedor. Este template é um empacotamento da Vertra Cloud e não é afiliado ao projeto Hermes Agent (licença MIT).
Requisitos e plano
1. Obtenha a chave do provedor
O Hermes funciona com OpenRouter (padrão), Anthropic, OpenAI, Google Gemini ou qualquer endpoint compatível com a OpenAI.
Copie a chave agora: a maioria dos provedores a mostra só uma vez. Ela é guardada apenas nas variáveis criptografadas do app.
2. Crie o agente
1
Abra o template
No dashboard, abra Templates, escolha Hermes Agent e clique em Use template.
2
Escolha provedor e modelo
Escolha o model provider e cole a API key. Com um endpoint compatível, informe também a base URL e o model, que é obrigatório. Para os demais, deixe o modelo vazio para usar o padrão do provedor, ou digite o modelo que preferir.
3
Chat no navegador (opcional)
Ative Browser chat (Hermes WebUI) se quiser uma página de chat com sessões, arquivos e configurações. Custa cerca de 150 MB de memória a mais. Sem ele, o agente continua funcionando no painel e nos seus canais.
4
Conecte canais (opcional)
Cada canal pede credenciais e a lista de pessoas autorizadas a falar com o agente, que é obrigatória. Veja o passo 4; você também pode fazer isso depois, no painel.
5
Crie
Dê um nome ao app e clique em Create. As saídas mostram o endereço do painel, o usuário
admin e uma senha gerada, mostrada uma única vez. Copie-a.3. Entre no painel e converse
Abra<address>/admin/. O navegador pede usuário e senha: use admin e a senha das saídas. Esse login único protege o painel e o chat.
- Chat no painel:
/admin/chaté o chat de terminal do Hermes. Diga olá por ali primeiro para conferir se a chave funciona. - Chat no navegador: se você o ativou, ele fica em
<address>/com o mesmo login. Sem ele,/leva você ao painel. - Perdeu a senha? Altere a variável
HERMES_ADMIN_PASSWORDno app e reinicie.
4. Conecte um canal
Cada canal precisa de duas coisas: a credencial do bot e quem pode falar com o agente. O Hermes ignora todo mundo que não está nessa lista, então o agente nunca responde a estranhos. Você pode preencher isso no assistente ou depois em Channels (/admin/channels).
- Telegram
- Discord
- Slack
- WhatsApp
- Email
- No Telegram, fale com o @BotFather, envie
/newbote siga as perguntas. Copie o bot token. - Descubra seu id numérico falando com o @userinfobot.
- Informe o token e o seu id como usuário permitido.
- Abra uma conversa com o seu bot e envie uma mensagem.
/admin/channels ou nas variáveis do app. O Signal precisa de um daemon signal-cli externo e não roda neste container.
5. Mude o modelo depois
O provedor e o modelo são aplicados a cada inicialização a partir das variáveis do app, então as variáveis são a fonte da verdade. Para mudá-los, edite estas variáveis no app e reinicie:Skills, memória e agendamentos
- Skills. O Hermes sincroniza as skills no primeiro boot; você as gerencia no painel.
- Memória. Memórias, sessões, skills e configuração ficam em
/app/.hermes, no disco do app, então sobrevivem a reinícios, atualizações e rollbacks. - Agendamentos. Em Cron você cria tarefas recorrentes. O agente as executa e fala com você pelo canal que você escolher.
O custo da IA é seu
A plataforma cobra do plano a memória que o app usa. As chamadas ao modelo são cobradas pelo seu provedor, e um agente que executa tarefas agendadas ou lê arquivos longos pode consumir muitos tokens. Defina um limite de gastos na conta do seu provedor e acompanhe o uso enquanto testa.Atualize e faça rollback
As novas versões chegam como novas versões do template. Um snapshot é feito antes da atualização, e um rollback traz o estado de volta (/app/.hermes). Veja Atualizar e fazer rollback. O deploy sem downtime está desligado: uma segunda cópia no mesmo disco encerra com erro.
Limites que você precisa conhecer
- O Caddy é a única barreira, sem limite de tentativas. A senha gerada é longa; para mais proteção, adicione uma regra de rate limit no seu próprio domínio.
- A senha gerada e a chave do provedor estão nas variáveis do app: não compartilhe capturas de tela delas.
- O canal de e-mail e os modelos padrão de cada provedor não foram testados com uma conta ou chave reais, então teste-os antes de depender deles.
Problemas comuns
401 em tudo
401 em tudo
Esse é o login. Use
admin e a senha das saídas, ou altere HERMES_ADMIN_PASSWORD e reinicie.O app morre logo depois de iniciar
O app morre logo depois de iniciar
Confira a memória (1,5 GB no mínimo) e o log do app.
HERMES_ADMIN_PASSWORD is required significa que a variável da senha está faltando.Um canal não responde
Um canal não responde
Abra o log do app. Um token inválido aparece ali (“token … was rejected”) e o app continua no ar com esse canal parado. Não compartilhe esse log. Depois confira se o seu próprio id está na lista de permitidos.
Editei o config.yaml e ele voltou
Editei o config.yaml e ele voltou
O provedor e o modelo são reaplicados a partir das variáveis a cada inicialização. Altere as variáveis e reinicie.
O QR code do WhatsApp não aparece ou expirou
O QR code do WhatsApp não aparece ou expirou
Recarregue Channels > WhatsApp e escaneie na hora. A primeira vez demora mais porque a bridge é baixada.
Relacionados
Hermes Agent no catálogo
O que o template cria e suas variáveis.
Atualizar e fazer rollback
O snapshot de segurança e o rollback.
Página pública
O template na galeria pública.
Usar um template
A galeria, o assistente e as saídas.