Visão Geral das Integrações

O Hermes Agent se conecta a sistemas externos para inferência de IA, servidores de ferramentas, fluxos de trabalho na IDE, acesso programático e mais. Essas integrações ampliam o que o Hermes consegue fazer e onde ele consegue rodar.

Comece por aqui

Se você só tem tempo de configurar uma integração, configure o Nous Portal — um único login OAuth cobre mais de 300 modelos e as quatro ferramentas do Tool Gateway (busca na web, geração de imagem, TTS e automação de navegador).

Provedores de IA e roteamento

O Hermes suporta vários provedores de inferência de IA de fábrica. Use hermes model para configurar de forma interativa, ou defina tudo no config.yaml.

• Provedores de IA — OpenRouter, Anthropic, OpenAI, Google e qualquer endpoint compatível com OpenAI. O Hermes detecta sozinho recursos como visão, streaming e uso de ferramentas em cada provedor.
• Roteamento de Provedores — Controle fino sobre quais provedores de fato atendem suas requisições no OpenRouter. Otimize por custo, velocidade ou qualidade com ordenação, listas de permissão, listas de bloqueio e ordem explícita de prioridade.
• Provedores de Reserva — Failover automático para provedores de LLM reservas quando o modelo principal encontra erros. Inclui reserva do modelo principal e reserva independente para tarefas auxiliares de visão, compressão e extração de conteúdo web.

Servidores de ferramentas (MCP)

• Servidores MCP — Conecte o Hermes a servidores de ferramentas externos via Model Context Protocol. Acesse ferramentas do GitHub, de bancos de dados, de sistemas de arquivos, de stacks de navegador, de APIs internas e mais, sem escrever ferramentas nativas do Hermes. Suporta os transportes stdio e SSE, filtragem de ferramentas por servidor e registro de recursos/prompts conforme as capacidades disponíveis.

Backends de busca na web

As ferramentas web_search e web_extract suportam oito provedores de backend, configurados pelo config.yaml ou por hermes tools:

Backend	Variável de ambiente	Busca	Extração	Crawl
Firecrawl (padrão)	FIRECRAWL_API_KEY	✔	✔	✔
SearXNG	SEARXNG_URL	✔	—	—
Brave (plano gratuito)	BRAVE_SEARCH_API_KEY	✔	—	—
DuckDuckGo (ddgs)	(nenhuma)	✔	—	—
Tavily	TAVILY_API_KEY (opcional)	✔	✔	—
Exa	EXA_API_KEY	✔	✔	—
Parallel	PARALLEL_API_KEY	✔	✔	—
xAI	XAI_API_KEY	✔	—	—

Exemplo rápido de configuração:

web:
  backend: firecrawl    # firecrawl | searxng | brave-free | ddgs | tavily | exa | parallel | xai

Se web.backend não estiver definido, o backend é detectado automaticamente a partir da chave de API disponível. O Firecrawl auto-hospedado também é suportado, via FIRECRAWL_API_URL. Escolher o Tavily em hermes tools funciona sem chave.

Automação de navegador

O Hermes traz automação de navegador completa, com várias opções de backend para navegar em sites, preencher formulários e extrair informações:

• Browser Use Cloud — Chromium gerenciado com modo furtivo, proxies residenciais, resolução de CAPTCHA e perfis de navegador reutilizáveis
• Browserbase — Provedor alternativo de navegador na nuvem, com navegadores gerenciados, ferramentas anti-bot, resolução de CAPTCHA e proxies residenciais
• CDP local da família Chromium — Conecte ao seu Chrome, Brave, Chromium ou Edge em execução com /browser connect
• Chromium local — Navegador local headless via a CLI agent-browser

Veja Automação de Navegador para instalação e uso.

Provedores de voz e TTS

Texto para fala e fala para texto em todas as plataformas de mensagens:

Provedor	Qualidade	Custo	Chave de API
Edge TTS (padrão)	Boa	Grátis	Nenhuma necessária
ElevenLabs	Excelente	Pago	ELEVENLABS_API_KEY
OpenAI TTS	Boa	Pago	VOICE_TOOLS_OPENAI_KEY
MiniMax	Boa	Pago	MINIMAX_API_KEY
xAI TTS	Boa	Pago	XAI_API_KEY
NeuTTS	Boa	Grátis	Nenhuma necessária

A conversão de fala para texto suporta oito provedores: faster-whisper local (grátis, roda no próprio dispositivo), um wrapper de comando local, Groq, OpenAI Whisper API, Mistral, xAI, ElevenLabs Scribe e DeepInfra. A transcrição de mensagens de voz funciona no Telegram, Discord, WhatsApp e outras plataformas de mensagens. Veja Voz e TTS e Modo de Voz para os detalhes.

Integração com IDE e editor

• Integração com IDE (ACP) — Use o Hermes Agent dentro de editores compatíveis com ACP, como VS Code, Zed e JetBrains. O Hermes roda como servidor ACP, renderizando mensagens de chat, atividade de ferramentas, diffs de arquivo e comandos de terminal dentro do editor.

Acesso programático

• Servidor de API — Exponha o Hermes como um endpoint HTTP compatível com OpenAI. Qualquer frontend que fale o formato da OpenAI — Open WebUI, LobeChat, LibreChat, NextChat, ChatBox — consegue se conectar e usar o Hermes como backend, com todo o conjunto de ferramentas.

Memória e personalização

• Memória embutida — Memória persistente e curada, via os arquivos MEMORY.md e USER.md. O agente mantém repositórios limitados de anotações pessoais e de dados de perfil do usuário que sobrevivem entre sessões.
• Provedores de Memória — Conecte backends de memória externos para uma personalização mais profunda. Oito provedores são suportados: Honcho (raciocínio dialético), OpenViking (recuperação em camadas), Mem0 (extração na nuvem), Hindsight (grafos de conhecimento), Holographic (SQLite local), RetainDB (busca híbrida), ByteRover (baseado em CLI) e Supermemory.

Plataformas de mensagens

O Hermes roda como bot de gateway em mais de 27 plataformas de mensagens, todas configuradas pelo mesmo subsistema gateway:

• Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, E-mail, SMS, DingTalk, Feishu/Lark, WeCom, WeCom Callback, Weixin, BlueBubbles, Buzz, QQ Bot, Yuanbao, Home Assistant, Microsoft Teams, Reuniões do Microsoft Teams, Microsoft Graph Webhook, Google Chat, LINE, ntfy, SimpleX, Open WebUI, Webhooks

Veja a visão geral do Gateway de Mensagens para a tabela comparativa das plataformas e o guia de configuração.

Links de conexão rápida

As plataformas grandes têm uma URL canônica de "crie seu bot/app", e algumas aceitam parâmetros que já abrem o formulário certo. Pule a caça ao console e vá direto:

Plataforma	Link direto	O que abre
Telegram	t.me/BotFather	Conversa com o BotFather — envie /newbot para gerar um token de bot
Discord	discord.com/developers/applications?new_application=true	Developer Portal com o diálogo New Application já aberto
Slack	api.slack.com/apps?new_app=1	O diálogo Create New App — escolha From an app manifest e cole o manifesto que hermes slack manifest --agent-view gera
LINE	developers.line.biz/console	LINE Developers Console, para criar um canal de Messaging API
Feishu/Lark	open.feishu.cn/app	Console da plataforma aberta do Feishu, para criar um app personalizado

A página de configuração de cada plataforma explica o que fazer depois que você chegar lá.

Espaços de trabalho colaborativos

• Buzz — O espaço de trabalho de humanos + agentes da Block, baseado em Nostr. São três caminhos de integração: o Buzz Desktop sobe o Hermes como runtime ACP gerenciado, a ponte de relay buzz-acp hospeda uma identidade Hermes no lado do servidor, ou a plataforma nativa de gateway entra em canais do Buzz com memória, skills, aprovações e cron completos do Hermes. A página de visão geral compara os três.

Automação residencial

• Home Assistant — Controle dispositivos de casa inteligente por quatro ferramentas dedicadas (ha_list_entities, ha_get_state, ha_list_services, ha_call_service). O conjunto de ferramentas do Home Assistant ativa automaticamente quando HASS_TOKEN está configurado.

Plugins

• Sistema de Plugins — Estenda o Hermes com ferramentas próprias, hooks de ciclo de vida e comandos de CLI sem modificar o código principal. Os plugins são descobertos em ~/.hermes/plugins/, no diretório local do projeto .hermes/plugins/ e em entry points instalados via pip.
• Construa um Plugin — Guia passo a passo para criar plugins do Hermes com ferramentas, hooks e comandos de CLI.

Treinamento e avaliação

• Processamento em Lote — Rode o agente sobre centenas de prompts em paralelo, gerando dados de trajetória estruturados no formato ShareGPT para geração de dados de treino ou avaliação.

---