Hermes instalēšana un OmniProxy konfigurēšana

Hermes ir palīgs, kas var saglabāt sarunas un uzdevumu pieredzi, pārvēršot pabeigto darbu prasmēs, kuras vēlāk var izmantot atkārtoti. Izmantojot vienu vārteju (Gateway), tas var arī izveidot savienojumu ar Telegram, Discord, Slack, WhatsApp, Signal un termināli. Vārteja kalpo kā vienots ieejas punkts ziņojumu saņemšanai un pārsūtīšanai. Varat nosūtīt tam koda pārskatus, incidentu piezīmes vai klientu materiālus no saviem ierastajiem tērzēšanas rīkiem, pēc tam likt tam atgriezties repozitorijā un turpināt darbu.

Pirms sākat

Vispirms izvēlieties instalēšanas metodi, pamatojoties uz sava datora operētājsistēmu. macOS un Windows var tieši izmantot grafiskos instalētājus, savukārt Linux, macOS un WSL2 var izmantot termināļa skriptu. WSL2 ir Windows funkcija Linux vides palaišanai. Termux Android tālruņos un Docker ir savas instalēšanas metodes, taču šī rokasgrāmata aptver tikai instalēšanu parastos datoros.

Vēlaties logu

macOS, Windows

• macOS: atveriet DMG
• Windows: atveriet instalētāju
• Instalējiet lietotni sistēmā

Tikai terminālis

Linux, macOS, WSL2

• Viena install.sh komanda
• Izmantojiet install.ps1 Windows sistēmā
• Pēc instalēšanas ievadiet hermes

Vēl neizmantojiet šos

pip, brew, AUR

• Šīs instalēšanas metodes nav oficiāli atbalstītas
• Tās ir arī grūti atjaunināt pēc instalēšanas
• Tā vietā izmantojiet vienu no divām opcijām kreisajā pusē

Pirms sākat, sagatavojiet macOS, Windows vai Linux datoru un pārliecinieties, ka varat atvērt termināli un piekļūt GitHub. Ja plānojat instalēt Hermes ārējā diskdzinī, vispirms pievienojiet diskdzini un apstipriniet, ka tajā ir pietiekami daudz brīvas vietas.

Instalēšana un pirmā palaišana

Ja vēlaties grafisko lietotni

Dodieties uz lejupielādes sadaļu Hermes vietnē un lejupielādējiet instalētāju savai operētājsistēmai. Instalētājs jau ietver izpildlaika vidi, tāpēc nekas nav jākompilē lokāli, kad atverat to pirmo reizi.

• macOS: Atveriet DMG un pārvietojiet Hermes.app uz Applications. DMG ir instalācijas attēls, ko parasti izmanto macOS. Šis instalētājs atbalsta tikai Apple silicon; Intel Mac datori netiek atbalstīti.
• Windows: Atveriet .appinstaller failu ar Windows App Installer. Tas instalē parakstītu MSIX, lietojumprogrammu pakotnes veidu, ko izmanto Windows.
• Linux: Darbvirsmas instalētāji ir paredzēti macOS un Windows. Linux sistēmā izmantojiet tālāk norādīto termināļa komandu. Pēc instalēšanas varat palaist hermes desktop.

Ja jums ir nepieciešams tikai terminālis

Ja izmantojat Linux, macOS vai WSL2, terminālī palaidiet šo:

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

Izmantojot Windows iekļauto PowerShell, palaidiet:

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

Instalētājs lejupielādē Hermes kodu un programmas, kas nepieciešamas tā palaišanai. Ja lejupielāde tiek pārtraukta, palaidiet to pašu komandu vēlreiz. Pēc instalēšanas pabeigšanas aizveriet pašreizējo termināli, atveriet jaunu logu un ievadiet:

hermes

Ja redzat Hermes uzvedni, komanda ir gatava lietošanai. Pēc tam varat palaist hermes doctor; šī instalēšanas pārbaude pasaka, kas vēl trūkst.

Programmas glabāšana ārējā diskdzinī

2026. gada 9. oktobrī Hermes Agent v0.21.6 tika instalēts ārējā diskdzinī, kas pievienots Mac datoram. Programma tika saglabāta mapē /Volumes/AItools/tools/hermes-agent, palaidēja komanda atradās mapē ~/.local/bin/hermes, un konfigurācijas un sarunu dati palika mapē ~/.hermes.

Ja jūsu diskdzinim ir cits nosaukums, aizstājiet ceļu pēc --dir ar savu mapi. Diskdzinim ir jāpaliek pievienotam, kamēr Hermes darbojas.

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

Programma

Ārējais diskdzinis

• tools/hermes-agent
• Glabājiet kodu šeit

Komanda

~/.local/bin/hermes

• Ievadiet hermes terminālī
• Tas stājas spēkā pēc jauna loga atvēršanas

Konfigurācija un tērzēšanas

~/.hermes

• config.yaml ir šeit
• Iziet pirms diskdziņa atvienošanas

Savienojuma vērtību iegūšana no OmniProxy

Šeit Hermes izveido savienojumu ar OmniProxy, nevis tieši ar Grok vai Gemini. Konfigurējiet Grok un Gemini pakalpojumu URL OmniProxy; neievadiet tos tieši Hermes.

Jūsu dators

Hermes

→

Vietējā vārteja

OmniProxy

• Iekļaujiet /v1 adresē

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Modeļa ID ir precīzs nosaukums, ko API izmanto, lai identificētu modeli. Abiem modeļiem izmantojiet šādus nosaukumus:

• Grok ievadiet grok-4.7. xAI API ir https://api.x.ai/v1, un tērzēšanas pieprasījumi izmanto /v1/chat/completions. Skatiet Grok modeļu dokumentāciju.
• Gemini ievadiet gemini-3.8-flash. Google OpenAI saderīgais API ir https://generativelanguage.googleapis.com/v1beta/openai/. Skatiet Gemini OpenAI saderības dokumentāciju.

Lai pārslēgtu Hermes uz Gemini, mainiet tikai modeļa nosaukumu uz gemini-3.8-flash. Turpiniet izmantot OmniProxy adresi kā API galapunktu.

Nokopējiet galapunkta URL un atslēgu no OmniProxy, pēc tam ievadiet atbilstošo modeļa ID:

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

Bāzes URL ir galapunkts, uz kuru Hermes sūta pieprasījumus. Tam šeit jābeidzas ar /v1 . API atslēga ir atslēga, ko OmniProxy izsniedz Hermes. Aizstājiet vietturi ar savu vērtību un nepublicējiet to publiskā lapā.

Ja jūsu vietējai OmniProxy instancei nav nepieciešama atslēga, varat atstāt API atslēgu tukšu. Ja adrese ir pieejama kādam citam, jums vajadzētu izmantot atslēgu. Apstipriniet arī, ka adrese ir sasniedzama no vides, kurā darbojas Hermes. Ja Hermes un OmniProxy atrodas vienā datorā, varat izmantot vietējo adresi.

Rīka konfigurācijas ievadīšana

Vispirms iziet no pašreizējās tērzēšanas, pēc tam terminālī palaidiet šo:

hermes model

Atlasiet Custom endpoint (self-hosted / VLLM / etc.). Pielāgots galapunkts nozīmē, ka Hermes izveido savienojumu ar jūsu norādīto pakalpojuma adresi, nevis izmanto iepriekš iestatītu pakalpojumu sniedzēju.

Iestatīšanas vednis secīgi lūdz galapunkta URL, atslēgu un modeļa nosaukumu. Ievadiet trīs vērtības no iepriekšējās sadaļas. Lai izmantotu Gemini, ievadiet gemini-3.8-flash kā modeļa nosaukumu.

Varat arī rediģēt ~/.hermes/config.yaml tieši. YAML ir teksta formāts, kas izmanto atkāpi, lai attēlotu konfigurācijas attiecības. Šī konfigurācija izmanto Grok:

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

Lai izmantotu Gemini, mainiet default uz gemini-3.8-flash un atstājiet pārējās trīs vērtības nemainītas:

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

Pēc saglabāšanas palaidiet hermes vēlreiz un sāciet jaunu tērzēšanu. Jau atvērtā sesijā, /model var pārslēgties tikai starp pakalpojumu sniedzējiem, kas jau ir saglabāti; tas nevar pievienot šo konfigurāciju.

Reāla uzdevuma verifikācija

1

hermes doctor

• Instalēšanas pārbaude ir sekmīga

2

Nosūtiet īsu ziņojumu

• Skatiet atbildi no Hermes

3

Atveriet pieprasījumu žurnālus

• Pārbaudiet modeļa nosaukumu

1. Palaidiet hermes doctor lai pārbaudītu, vai instalēšana ir pabeigta.
2. Palaidiet hermes un palūdziet tam vienā teikumā paskaidrot, ko tas var darīt. Jums vajadzētu redzēt atbildi.
3. Atveriet OmniProxy pieprasījumu žurnālu, apstipriniet, ka pieprasījums nāca no Hermes, un pārbaudiet, vai modeļa nosaukums ir grok-4.7 vai gemini-3.8-flash.

Redzēt, ka iestatīšanas vednis veiksmīgi saglabāja, vai ka API atgrieza veiksmīgu atbildi, nav pietiekami, lai parādītu, ka Hermes var pabeigt uzdevumus jūsu vietā. Modeļa nosaukumam pieprasījumu žurnālā ir jāatbilst vērtībai, kuru ievadījāt.

Lai tērzētu pārlūkprogrammā, lokāli palaidiet šo:

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

Pēc tam atveriet http://127.0.0.1:9119. Šī adrese darbojas tikai pašreizējā datorā.

Biežākās kļūdas

• Ievadot hermes ziņo, ka komandu nevar atrast: Aizveriet termināli un atveriet jaunu logu. Ja komanda joprojām nav atrasta, apstipriniet, ka ~/.local/bin ir PATH. PATH ir direktoriju saraksts, kurā sistēma meklē komandas. Windows sistēmā apstipriniet, ka instalētāja pievienotā palaišanas direktorija ir PATH.
• Instalēšanas lejupielāde apstājas pusceļā: Palaidiet to pašu instalēšanas komandu vēlreiz. Jau lejupielādētās daļas tiks izmantotas atkārtoti.
• Hermes neatbild vai ziņo, ka nevar izveidot savienojumu: Apstipriniet, ka OmniProxy darbojas, un pārbaudiet, vai Bāzes URL beidzas ar /v1. Ja Hermes darbojas Docker, kamēr OmniProxy darbojas resursdatorā, neizmantojiet 127.0.0.1 ja tas ir derīgs tikai konteinerā.
• Parādās atslēgas kļūda: Atjauniniet OmniProxy atslēgu, pēc tam mainiet api_key mapē config.yaml. xAI vai Google atslēga pieder OmniProxy pakalpojumu sniedzēja iestatījumiem; neievadiet to šajā Hermes laukā.
• Modelis tiek ziņots kā nepieejams: Atveriet pašreizējo modeļu sarakstu OmniProxy un nokopējiet grok-4.7 vai gemini-3.8-flash precīzi tā, kā tas parādās sarakstā.
• Hermes atbild, bet nevar veikt uzdevumus, piemēram, lasīt failus vai izpildīt komandas: Pārslēdzieties uz citu modeli OmniProxy, kuram ir šīs iespējas, pēc tam sāciet jaunu Hermes sesiju.
• Programma atrodas ārējā diskdzinī, un hermes doctor ziņo par krātuves kļūdu pēc diskdziņa atvienošanas: Vispirms atkārtoti pievienojiet diskdzini. Neļaujiet Hermes izveidot atsevišķu konfigurāciju, kamēr diskdzinis ir atvienots.

Atsauces

Instalēšanas darbības skatiet Hermes instalēšanas dokumentācijā un platformas atbalstā. Pielāgota galapunkta konfigurācijai skatiet Hermes pakalpojumu sniedzēja dokumentāciju. Modeļu ID skatiet Grok modeļu dokumentācijā un Gemini OpenAI saderības dokumentācijā.

macOS instalēšanas process tika pabeigts 2026. gada 9. oktobrī, izmantojot Hermes Agent v0.21.6. grok-4.7 un gemini-3.8-flash bija standarta modeļu ID xAI un Google dokumentācijā tajā datumā. Ievadot vērtības, izmantojiet OmniProxy parādītos nosaukumus.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · Hermes ↗