Instal·lació de Hermes i configuració d'OmniProxy

Hermes és un assistent que pot retenir converses i experiència en tasques, convertint el treball completat en habilitats que es poden reutilitzar més tard. A través d’una única passarel·la, també es pot connectar a Telegram, Discord, Slack, WhatsApp, Signal i el terminal. La passarel·la serveix com a punt d’entrada unificat per rebre i reenviar missatges. Pots enviar-li revisions de codi, notes d’incidents o materials de clients des de les teves eines de xat habituals, i després fer que torni al repositori i continuï treballant.

Abans de començar

Primer, tria un mètode d’instal·lació basat en el sistema operatiu del teu ordinador. macOS i Windows poden utilitzar instal·ladors gràfics directament, mentre que Linux, macOS i WSL2 poden utilitzar un script de terminal. WSL2 és una característica de Windows per executar un entorn Linux. Termux en telèfons Android i Docker tenen els seus propis mètodes d’instal·lació, però aquesta guia només cobreix la instal·lació en ordinadors normals.

Vols una finestra

macOS, Windows

macOS: obre el DMG
Windows: obre l'instal·lador
Instal·la l'aplicació al sistema

Només terminal

Linux, macOS, WSL2

Una ordre install.sh
Utilitza install.ps1 en Windows
Introdueix hermes després de la instal·lació

No utilitzis aquests encara

pip, brew, AUR

Aquests mètodes d'instal·lació no estan oficialment admesos
També són difícils d'actualitzar després de la instal·lació
Utilitza una de les dues opcions de l'esquerra en el seu lloc

Aquesta guia cobreix dues rutes: instal·ladors gràfics i scripts de terminal. pip, brew i AUR no són mètodes d'instal·lació oficialment admesos.

Abans de començar, prepara un ordinador amb macOS, Windows o Linux i assegura’t que pugui obrir un terminal i accedir a GitHub. Si tens previst instal·lar Hermes en una unitat externa, connecta la unitat primer i confirma que té prou espai lliure.

Instal·lació i llançament per primera vegada

Si vols una aplicació gràfica

Ves a la secció de descàrregues del lloc web d’Hermes i descarrega l’instal·lador per al teu sistema operatiu. L’instal·lador ja inclou l’entorn d’execució, així que no cal compilar res localment quan l’obris per primera vegada.

macOS: Obre el DMG i mou Hermes.app a Aplicacions. Un DMG és una imatge d’instal·lació utilitzada habitualment en macOS. Aquest instal·lador només admet Apple silicon; els Macs Intel no són compatibles.
Windows: Obre el fitxer .appinstaller amb Windows App Installer. Instal·la un MSIX signat, un tipus de paquet d’aplicació utilitzat per Windows.
Linux: Els instal·ladors d’escriptori són per a macOS i Windows. En Linux, utilitza l’ordre de terminal següent. Després de la instal·lació, pots executar hermes desktop.

Si només necessites el terminal

Si utilitzes Linux, macOS o WSL2, executa això en un terminal:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Quan utilitzis el PowerShell inclòs amb Windows, executa:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

L’instal·lador descarrega el codi d’Hermes i els programes necessaris per executar-lo. Si la descàrrega s’interromp, executa la mateixa ordre de nou. Després que la instal·lació finalitzi, tanca el terminal actual, obre una finestra nova i introdueix:

hermes

Si veus l’indicador d’Hermes, l’ordre està llesta per utilitzar-se. Després pots executar hermes doctor; aquesta comprovació d’instal·lació et diu què falta encara.

Emmagatzema el programa en una unitat externa

El 9 d’octubre de 2026, Hermes Agent v0.21.6 es va instal·lar en una unitat externa connectada a un Mac. El programa es va emmagatzemar a /Volumes/AItools/tools/hermes-agent, l’ordre de llançament es trobava a ~/.local/bin/hermes, i les dades de configuració i conversa van romandre a ~/.hermes.

Si la teva unitat té un nom diferent, substitueix el camí després de --dir per la teva pròpia carpeta. La unitat ha de romandre connectada mentre Hermes s’estigui executant.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Programa

Unitat externa

tools/hermes-agent
Mantén el codi aquí

Ordre

~/.local/bin/hermes

Introdueix hermes al terminal
Té efecte després d'obrir una finestra nova

Configuració i xats

~/.hermes

config.yaml és aquí
Surt abans de desconnectar la unitat

Així és com es van organitzar els fitxers en aquell Mac. Una instal·lació per defecte col·loca el programa al directori d'usuari, amb el mateix resultat: obre un terminal nou i introdueix hermes.

Obtenir valors de connexió d’OmniProxy

Aquí, Hermes es connecta a OmniProxy en lloc de directament a Grok o Gemini. Configura els URLs de servei de Grok i Gemini a OmniProxy; no els introdueixis directament a Hermes.

El teu ordinador

Hermes

Passarel·la local

OmniProxy

Inclou /v1 a l'adreça

Grok

grok-4.7

Gemini

gemini-3.8-flash

Hermes veu OmniProxy. OmniProxy reenvia les sol·licituds a Grok i Gemini.

Un ID de model és el nom exacte que utilitza l’API per identificar un model. Utilitza els noms següents per als dos models:

Per a Grok, introdueix grok-4.7. L’API de xAI és https://api.x.ai/v1, i les sol·licituds de xat utilitzen /v1/chat/completions. Vegeu la documentació del model Grok.
Per a Gemini, introdueix gemini-3.8-flash. L’API compatible amb OpenAI de Google és https://generativelanguage.googleapis.com/v1beta/openai/. Vegeu la documentació de compatibilitat amb OpenAI de Gemini.

Per canviar Hermes a Gemini, només has de canviar el nom del model a gemini-3.8-flash. Continua utilitzant l’adreça d’OmniProxy com a punt final de l’API.

Copia l’URL del punt final i la clau d’OmniProxy, després introdueix l’ID del model corresponent:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL és el punt final al qual Hermes envia les sol·licituds. Ha d’acabar amb /v1 aquí. API Key és la clau que OmniProxy emet a Hermes. Substitueix el marcador de posició pel teu propi valor i no el publiquis en una pàgina pública.

Si la teva instància local d’OmniProxy no requereix una clau, pots deixar API Key buida. Si l’adreça és accessible per a qualsevol altra persona, hauries d’utilitzar una clau. Confirma també que l’adreça sigui accessible des de l’entorn on s’executa Hermes. Si Hermes i OmniProxy estan al mateix ordinador, pots utilitzar una adreça local.

Entrar la configuració de l’eina

Primer, surt del xat actual, després executa això en un terminal:

hermes model

Selecciona Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint significa que Hermes es connecta a una adreça de servei que especifiques en lloc d’utilitzar un proveïdor preestablert.

L’assistent de configuració demana l’URL del punt final, la clau i el nom del model en seqüència. Introdueix els tres valors de la secció anterior. Per utilitzar Gemini, introdueix gemini-3.8-flash com a nom del model.

També pots editar ~/.hermes/config.yaml directament. YAML és un format de text que utilitza sagnat per representar relacions de configuració. La configuració següent utilitza Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Per utilitzar Gemini, canvia default a gemini-3.8-flash i deixa els altres tres valors sense canvis:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Després de desar, executa hermes de nou i inicia un xat nou. En una sessió ja oberta, /model només pot canviar entre proveïdors que ja s’han desat; no pot afegir aquesta configuració.

Verificar amb una tasca real

hermes doctor

La comprovació d'instal·lació passa

Envia un missatge curt

Veure una resposta d'Hermes

Obre els registres de sol·licituds

Verifica el nom del model

La configuració només es pot utilitzar després que els tres passos estiguin complets.

Executa hermes doctor per comprovar si la instal·lació està completa.
Executa hermes i demana-li que expliqui en una frase què pot fer. Hauries de veure una resposta.
Obre el registre de sol·licituds d’OmniProxy, confirma que la sol·licitud prové d’Hermes i comprova si el nom del model és grok-4.7 o gemini-3.8-flash.

Veure que l’assistent de configuració s’ha desat correctament, o que l’API ha retornat una resposta correcta, no és suficient per demostrar que Hermes pot completar tasques per a tu. El nom del model al registre de sol·licituds ha de coincidir amb el valor que has introduït.

Per xatejar en un navegador, executa el següent localment:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Després obre http://127.0.0.1:9119. Aquesta adreça només funciona a l’ordinador actual.

Errors comuns

Introduir hermes informa que l’ordre no es pot trobar: Tanca el terminal i obre una finestra nova. Si l’ordre encara no es troba, confirma que ~/.local/bin està a PATH. PATH és la llista de directoris on el sistema busca ordres. En Windows, confirma que el directori de llançament afegit per l’instal·lador està a PATH.
La descàrrega de la instal·lació s’atura a mig camí: Executa la mateixa ordre d’instal·lació de nou. Les parts ja descarregades es reutilitzaran.
Hermes no respon o informa que no es pot connectar: Confirma que OmniProxy està en marxa i comprova que Base URL acabi amb /v1. Si Hermes s’executa en Docker mentre OmniProxy s’executa a l’amfitrió, no utilitzis 127.0.0.1 si només és vàlid dins del contenidor.
Apareix un error de clau: Actualitza la clau d’OmniProxy, després canvia api_key a config.yaml. La clau de xAI o Google pertany a la configuració del proveïdor d’OmniProxy; no l’introdueixis en aquest camp d’Hermes.
El model s’informa com a no disponible: Obre la llista de models actual a OmniProxy i copia grok-4.7 o gemini-3.8-flash exactament com apareix a la llista.
Hermes respon però no pot realitzar tasques com llegir fitxers o executar ordres: Canvia a un altre model a OmniProxy que tingui aquestes capacitats, després inicia una sessió nova d’Hermes.
El programa està en una unitat externa, i hermes doctor informa d’un error d’emmagatzematge després que la unitat es desconnecti: Connecta la unitat primer. No deixis que Hermes creï una configuració separada mentre la unitat està desconnectada.

Referències

Per als passos d’instal·lació, vegeu la documentació d’instal·lació d’Hermes i suport de plataforma. Per a la configuració de Custom endpoint, vegeu la documentació del proveïdor d’Hermes. Per als IDs de models, vegeu la documentació del model Grok i la documentació de compatibilitat amb OpenAI de Gemini.

El procés d’instal·lació en macOS es va completar el 09-10-2026 utilitzant Hermes Agent v0.21.6. grok-4.7 i gemini-3.8-flash eren els IDs de models estàndard a la documentació de xAI i Google en aquella data. Quan introdueixis els valors, utilitza els noms mostrats a OmniProxy.

Substitueix cada marcador de posició amb valors de la teva pròpia configuració d'OmniProxy. No publiquis mai una clau real.

Un resultat guardat o HTTP 200 sols no demostra compatibilitat completa de l'Agent. Comprova la font i el model al registre de crides d'OmniProxy.

Fonts oficials · Hermes ↗