> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Template Hermes Agent na Vertra Cloud: agente de IA com painel e canais

> O que o template do Hermes Agent cria na Vertra Cloud: memória, o que ele pergunta, canais, variáveis e licença. O passo a passo completo está no guia.

Um agente de IA que aprende com o uso, com painel web, chat opcional no navegador e canais de mensagem. O template executa o Hermes Agent v0.22.5 atrás de um único login. Você traz a chave do modelo: a Vertra Cloud não hospeda modelo.

> [card] [Guia passo a passo: Hermes Agent da chave aos seus canais](https://docs.vertracloud.app/pt-br/templates/guides/hermes-agent.md)
>
> Chave do provedor, Telegram, Discord, Slack e WhatsApp, o login do painel, o chat no navegador e a troca de modelo.

## O que ele cria

Um app (imagem). **Memória: 1,5 GB no mínimo**, 2 GB recomendado. Exige um plano com imagens Docker e uma [vaga de imagem](https://docs.vertracloud.app/pt-br/templates/overview.md#vagas-de-imagem) livre; veja [Planos e limites](https://docs.vertracloud.app/pt-br/plans-and-limits.md).

## O que o assistente pergunta

| Pergunta | O que faz |
| - | - |
| Model provider | OpenRouter (padrão), Anthropic, OpenAI, Google Gemini ou um endpoint compatível com a OpenAI. |
| Provider API key | Guardada apenas nas variáveis criptografadas do app. |
| Base URL and model | A URL somente com um endpoint compatível (termina em `/v1`). Modelo vazio significa o padrão do provedor; obrigatório com um endpoint compatível. |
| Browser chat (Hermes WebUI) | Opcional; cerca de 150 MB de memória a mais. |
| Telegram, Discord, Slack, WhatsApp, email | Cada um pede credenciais e a **lista de pessoas autorizadas a falar com o agente**. |

## O que você recebe

O painel em `<address>/admin/`, o usuário `admin` e uma **senha gerada mostrada uma única vez**, e o próximo passo. O WhatsApp é pareado por QR code no painel.

## Variáveis

| Variável | O que faz |
| - | - |
| `HERMES_ADMIN_USER`, `HERMES_ADMIN_PASSWORD` | O login único (`admin` e a senha gerada). |
| `HERMES_WEBUI` | `true` ou `false`: o chat no navegador. |
| `HERMES_MODEL_PROVIDER`, `HERMES_MODEL`, `HERMES_MODEL_CUSTOM`, `HERMES_BASE_URL` | Provedor e modelo, aplicados a cada inicialização. |
| `OPENROUTER_API_KEY`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `OPENAI_COMPAT_API_KEY` | A chave do provedor escolhido. |
| `TELEGRAM_*`, `DISCORD_*`, `SLACK_*`, `WHATSAPP_*`, `EMAIL_*` | As credenciais e a lista de permitidos de cada canal. |

## Recursos e limites

* Porta 8080. Primeiro boot de 15 a 30 segundos; as inicializações seguintes levam cerca de 15 segundos.
* Estado em `/app/.hermes`. A imagem é grande, então o primeiro deploy demora mais.
* O deploy sem downtime está desligado; o rollback devolve o estado também.
* Um token de canal inválido aparece no log do app: não o compartilhe.

## Licença

O Hermes Agent é distribuído sob a [licença MIT](https://github.com/NousResearch/hermes-agent/blob/main/LICENSE). O chat opcional é o Hermes WebUI (MIT) e o proxy de login é o Caddy (Apache-2.0). Este template é um empacotamento da Vertra Cloud e não é afiliado ao projeto.

Veja também a [página pública](https://vertracloud.app/templates/hermes-agent) e os [outros templates oficiais](https://docs.vertracloud.app/pt-br/templates/catalog.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.