> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-ce69695c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Configure a Venice como provedora no Hermes Agent da Nous Research para IA privada com memória persistente, skills e acesso a mais de 230 modelos.

O [Hermes Agent](https://hermes-agent.nousresearch.com) é um agente de IA de código aberto, auto-hospedado, construído pela [Nous Research](https://nousresearch.com). Ele oferece memória persistente, criação autônoma de skills e um loop de aprendizado embutido que fica mais capaz quanto mais tempo roda. Aponte-o para a API Venice e seu agente ganha acesso a mais de 230 modelos e ferramentas para texto, imagem, vídeo, áudio, embeddings e mais.

<Card title="Documentação do Hermes Agent" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  Documentação completa, configuração de provedores e opções de configuração na documentação oficial do Hermes Agent.
</Card>

## Por que Venice + Hermes Agent?

A API Venice dá ao seu Hermes Agent acesso à plataforma Venice completa por meio de um único endpoint compatível com OpenAI.

| Capacidade | O que você ganha |
| - | - |
| **Texto e chat** | Modelos privados e anonimizados (GLM, Qwen, Claude, GPT e mais) |
| **Imagem** | Geração, edição, upscaling e remoção de fundo |
| **Vídeo** | Geração, edição, upscaling e análise com modelos de chat compatíveis com vídeo |
| **Áudio** | Síntese de fala (TTS), geração de música e fala para texto |
| **Embeddings** | Embeddings vetoriais para RAG e busca semântica |
| **Ferramentas** | Web scraping, busca na web, parsing de texto e RPC crypto |

<CardGroup cols={3}>
  <Card title="Inferência privada" icon="shield-halved">
    Zero retenção de dados. Prompts nunca são armazenados nem registrados
  </Card>

  <Card title="Memória persistente" icon="brain">
    O Hermes lembra do contexto entre sessões e reinicializações
  </Card>

  <Card title="Mais de 15 plataformas" icon="comments">
    Alcance seu agente no Telegram, Discord, Slack, WhatsApp e mais
  </Card>
</CardGroup>

## Configuração

### 1. Instale o Hermes Agent

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="WSL2 (Windows)">
    Instale o [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) primeiro, depois execute o mesmo comando:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

Após a instalação, recarregue seu shell:

```bash theme={null}
source ~/.zshrc   # ou: source ~/.bashrc
```

### 2. Configure a Venice como seu provedor

Execute o assistente de configuração de modelo:

```bash theme={null}
hermes model
```

Selecione **Custom endpoint (self-hosted / VLLM / etc.)** e insira o seguinte quando solicitado:

| Campo | Valor |
| - | - |
| **API base URL** | `https://api.venice.ai/api/v1` |
| **API key** | Sua chave de API Venice |
| **Model name** | Um ID de modelo Venice (veja abaixo) |

Obtenha uma chave de API em [venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation) se ainda não tiver uma.

<Tip>
  Você também pode configurar a Venice diretamente em `~/.hermes/config.yaml`:

  ```yaml theme={null}
  model:
    default: zai-org-glm-5
    provider: custom
    base_url: https://api.venice.ai/api/v1
    api_key: ${VENICE_API_KEY}
  ```

  E definir a chave em `~/.hermes/.env`:

  ```bash theme={null}
  VENICE_API_KEY=your-key-here
  ```
</Tip>

### 3. Escolha um modelo

Quando o assistente perguntar sobre um modelo, escolha um com base no seu caso de uso:

| Caso de uso | Modelo | Privacidade |
| - | - | - |
| Geral | `zai-org-glm-5` | Privado |
| Raciocínio | `kimi-k2-6` | Privado |
| Codificação | `claude-opus-4-7` | Anonimizado |
| Visão | `z-ai-glm-5v-turbo` | Anonimizado |
| Sem censura | `venice-uncensored-1-2` | Privado |

Troque seu modelo a qualquer momento, sem precisar reiniciar:

```bash theme={null}
hermes model              # assistente completo
```

Ou troque no meio da sessão:

```text theme={null}
/model custom:claude-opus-4-7
```

### 4. Comece a conversar

Abra o CLI clássico ou a TUI moderna:

```bash theme={null}
hermes            # CLI clássico
hermes --tui      # TUI moderna (recomendada)
```

Experimente um prompt para verificar se tudo funciona:

```text theme={null}
Summarize this repo in 5 bullets and tell me what the main entrypoint is.
```

## Conecte plataformas de mensagens

Quando o CLI estiver funcionando, conecte seus aplicativos de mensagens via gateway:

```bash theme={null}
hermes gateway setup
```

Isso te guia pela conexão de Telegram, Discord, Slack, WhatsApp, Signal e outras plataformas. Seu agente fica acessível por qualquer canal conectado, tudo impulsionado pela Venice.

```bash theme={null}
hermes gateway      # inicia o gateway de mensagens
```

## Modos de privacidade

Os modelos Venice no Hermes Agent seguem os mesmos [níveis de privacidade](/overview/privacy) da API Venice:

* Modelos **Privados** (GLM, Qwen, DeepSeek, Llama, Venice Uncensored) rodam na frota de GPUs da Venice. Os prompts nunca são armazenados nem registrados.
* Modelos **Anonimizados** (Claude, GPT, Gemini, Grok) são intermediados pela Venice com todas as informações identificáveis removidas. O provedor terceiro vê a Venice como cliente, não você.

## Skills da API Venice

O Hermes Agent tem um sistema de skills integrado compatível com o formato [Agent Skills](https://github.com/veniceai/skills). A Venice publica skills oficiais que ensinam seu agente a usar cada endpoint Venice (chat, geração de imagens, vídeo, áudio, embeddings, ferramentas de augment e mais).

Instale as skills Venice diretamente do GitHub:

```bash theme={null}
hermes skills install veniceai/skills
```

Ou pesquise por skills individuais:

```bash theme={null}
hermes skills search venice
```

O Hermes descobre cada skill pelo frontmatter de seu `SKILL.md` e o carrega sob demanda.

## Comandos principais

| Comando | Descrição |
| - | - |
| `hermes` | Iniciar conversa |
| `hermes model` | Mudar provedor ou modelo |
| `hermes tools` | Configurar quais ferramentas estão habilitadas |
| `hermes gateway` | Iniciar o gateway de mensagens |
| `hermes --continue` | Retomar sua última sessão |
| `hermes doctor` | Diagnosticar problemas |
| `hermes update` | Atualizar para a versão mais recente |

## Recursos

<CardGroup cols={2}>
  <Card title="Documentação do Hermes Agent" icon="book" href="https://hermes-agent.nousresearch.com/docs/">
    Documentação oficial
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    Código-fonte e releases
  </Card>

  <Card title="Catálogo de modelos Venice" icon="list" href="/models/text">
    Navegue pelos modelos disponíveis
  </Card>

  <Card title="Privacidade Venice" icon="shield-halved" href="/overview/privacy">
    Como a Venice protege seus dados
  </Card>
</CardGroup>


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