Hermes Agent com Venice | Documentação da API Venice

O Hermes Agent é um agente de IA de código aberto, auto-hospedado, construído pela Nous Research. 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.

Documentação do Hermes Agent

Documentação completa, configuração de provedores e opções de configuração na documentação oficial do Hermes Agent.

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 e transcrição
Á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

Inferência privada

Zero retenção de dados. Prompts nunca são armazenados nem registrados

Memória persistente

O Hermes lembra do contexto entre sessões e reinicializações

Mais de 15 plataformas

Alcance seu agente no Telegram, Discord, Slack, WhatsApp e mais

Configuração

1. Instale o Hermes Agent

macOS / Linux
WSL2 (Windows)

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

Instale o WSL2 primeiro, depois execute o mesmo comando:

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

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

source ~/.zshrc   # ou: source ~/.bashrc

2. Configure a Venice como seu provedor

Execute o assistente de configuração de modelo:

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 se ainda não tiver uma.

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

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:

VENICE_API_KEY=your-key-here

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:

hermes model              # assistente completo

Ou troque no meio da sessão:

/model custom:claude-opus-4-7

4. Comece a conversar

Abra o CLI clássico ou a TUI moderna:

hermes            # CLI clássico
hermes --tui      # TUI moderna (recomendada)

Experimente um prompt para verificar se tudo funciona:

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:

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.

hermes gateway      # inicia o gateway de mensagens

Modos de privacidade

Os modelos Venice no Hermes Agent seguem os mesmos níveis de privacidade 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. 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:

hermes skills install veniceai/skills

Ou pesquise por skills individuais:

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

Documentação do Hermes Agent

Documentação oficial

GitHub

Código-fonte e releases

Catálogo de modelos Venice

Navegue pelos modelos disponíveis

Privacidade Venice

Como a Venice protege seus dados

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

Hermes Agent

Documentação do Hermes Agent

Por que Venice + Hermes Agent?

Inferência privada

Memória persistente

Mais de 15 plataformas

Configuração

1. Instale o Hermes Agent

2. Configure a Venice como seu provedor

3. Escolha um modelo

4. Comece a conversar

Conecte plataformas de mensagens

Modos de privacidade

Skills da API Venice

Comandos principais

Recursos

Documentação do Hermes Agent

GitHub

Catálogo de modelos Venice

Privacidade Venice

Documentação do Hermes Agent

​Por que Venice + Hermes Agent?

Inferência privada

Memória persistente

Mais de 15 plataformas

​Configuração

​1. Instale o Hermes Agent

​2. Configure a Venice como seu provedor

​3. Escolha um modelo

​4. Comece a conversar

​Conecte plataformas de mensagens

​Modos de privacidade

​Skills da API Venice

​Comandos principais

​Recursos

Documentação do Hermes Agent

GitHub

Catálogo de modelos Venice

Privacidade Venice

Por que Venice + Hermes Agent?

Configuração

1. Instale o Hermes Agent

2. Configure a Venice como seu provedor

3. Escolha um modelo

4. Comece a conversar

Conecte plataformas de mensagens

Modos de privacidade

Skills da API Venice

Comandos principais

Recursos