Hermes Agent: Mikä se on, miten se asennetaan ja määritetään

Claude Code, Codex, Cursor, OpenClaw – jokaisella näistä tekoälyagenteista on oma roolinsa. Jos tarvitset agentin, joka toimii palvelimellasi, muistaa sinut istuntojen välillä ja vastaa Telegramissa, kun olet taksissa, Hermes Agent sopii tähän tarkoitukseen.

Hermes Agent on Nous Researchin avoin projekti, ja sen asentaminen on paljon helpompaa kuin moni luulee. Tässä käydään läpi, mikä se on, mitä se maksaa, miten se asennetaan Windowsiin, macOS:ään tai Linuxiin sekä miten siihen yhdistetään malli ja Telegram-botti. Kaikki perustuu viralliseen dokumentaatioon.

Mikä Hermes Agent on selkokielellä?#

Hermes kuuluu samaan luokkaan kuin Claude Code tai Codex: se on tekoälyagentti, joka ei vain kirjoita vastauksia vaan myös avaa tiedostoja, suorittaa päätekomentoja ja käyttää selainta. Ero on sen toteutustavassa: Claude Code on sidottu Anthropicin malleihin, kun taas Hermes toimii minkä tahansa mallipalveluntarjoajan kanssa – Claudesta ja GPT:stä laitteistollasi toimiviin paikallisiin malleihin.

Projekti on nuori: sen GitHub-arkisto luotiin 22. heinäkuuta 2025. Siitä huolimatta sillä oli 22. elokuuta 2026 mennessä yli 234 000 tähteä ja 47 000 forkia, mikä tekee siitä yhden tämän luokan nopeimmin kasvavista avoimista projekteista. Koodi on kokonaan avointa MIT-lisenssillä: voit lukea ja muokata sitä sekä käyttää sitä tuotteissasi ilman rojaltimaksuja.

Tämän ”itsensä kehittämisen” taustalla on kaksi konkreettista mekanismia: taidot ja muisti. Taidot ovat toimintatapoja, jotka agentti kirjoittaa muistiin vaativien tehtävien jälkeen ja joita se käyttää seuraavalla kerralla. Muisti on tiedosto, joka sisältää tietoja sinusta ja ympäristöstäsi ja joka ladataan jokaiseen uuteen keskusteluun. Molempia mekanismeja käsitellään alempana omassa osiossaan.

Miten Hermes Agent eroaa Claude Codesta ja Codexista?#

Tärkeimmät erot on koottu tähän taulukkoon:

Taulukosta käy ilmi tärkein ero. Claude Code sopii tehtäviin, jotka vaativat vahvimman mallin ja työskentelyä koodivarastossa – Anthropicilla on edelleen paras mallin ja työkalujen yhdistelmä tähän. Hermes on tarkoitettu tilanteisiin, joissa tarvitset ”aina päällä” olevan agentin: se toimii palvelimella, tekee jotain joka aamu ajastetusti, vastaa sinulle Telegramissa ja muistaa eilisen keskustelun.

Jos vertailet perustyökaluja, tarjolla on erilliset oppaat siitä, miten Claude Code asennetaan, mikä OpenAI Codex on ja millainen tekoälyn koodaustyökalujen kenttä on vuonna 2026.

Mitä Hermes Agent maksaa vuonna 2026?#

Helpoin vaihtoehto on Nous Portal, Hermes-kehittäjien oma tilauspalvelu. Se kattaa yli kolmesataa mallia ja sisältää myös valmiita palveluja: verkkohaku, kuvien luonti, puhesynteesi ja pilviselain. 22. elokuuta 2026 tilaukset olivat seuraavat:

Toinen vaihtoehto, jonka moni sivuuttaa, on se, ettei uutta tilausta tarvitse lainkaan tehdä. Hermes voi kirjautua OAuthin kautta eli käyttää tiliä, joka sinulla jo on. Se tukee ChatGPT- ja Codex-tilauksia, Claude Maxia, xAI:n SuperGrokia, Qwenia, MiniMaxia ja GitHub Copilotia. Valitse palveluntarjoaja asennuksessa, vahvista kirjautuminen selaimessa ja maksat sen jälkeen täsmälleen kuten ennenkin.

Kolmas vaihtoehto on käyttää omia API-avaimia. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba ja noin tusina muuta palveluntarjoajaa: syötä avain, niin käyttö laskutetaan suoraan kyseiseltä tililtä.

Neljäs vaihtoehto ei maksa rahaa, mutta vaatii laitteiston: paikallisen mallin Ollamin tai LM Studion kautta. Tämä sopii, jos sinulla on tehokas tietokone etkä halua lähettää tietoja sen ulkopuolelle. Yksi ehto on: mallin konteksti-ikkunan on oltava vähintään 64 000 tokenia, muuten Hermes kieltäytyy käynnistymästä sen kanssa – agentti tarvitsee riittävästi työmuistia pitkiä tehtäviä varten.

Ulkomaisten palvelujen maksuehtoja ei käsitellä tässä – se on erillinen aihe omine sääntöineen, ja sitä käsitellään tässä oppaassa Claude Coden esimerkin avulla.

Hermes Agentin asentaminen Windowsiin#

Jos pääte ei ole sinulle tuttu, aloita asennusohjelmasta. Sivustolla hermes-agent.nousresearch.com on latauspainikkeet macOS 12+:lle, Windows 10/11:lle ja Linuxille. Ladattu tiedosto asentaa molemmat sovellukset kerralla: hermes-komentorivin ja Hermes Desktopin – tavallisen ikkunan, jossa on chat, tiedostot ja asetukset.

Jos komentojen käyttö on sinulle tuttua, asenna PowerShellin kautta:

1. Avaa PowerShell

   Paina Win-näppäintä, kirjoita PowerShell ja avaa se. Järjestelmänvalvojan oikeuksia ei tarvita.

2. Suorita asennusohjelma

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

   Komentosarja lataa kaiken tarvitsemansa: Python 3.11:n, Node.js 22:n, uv-pakettienhallinnan, ripgrepin ja ffmpegin. Jos Git puuttuu, se asentaa oman eristetyn MinGit-version, joka tallennetaan erikseen eikä koske järjestelmän ohjelmiin.

3. Käynnistä pääte uudelleen ja tarkista asennus

   hermes doctor
   

   Komento näyttää, mikä on asennettu, mitä puuttuu ja miten puutteet korjataan. Jos näet vihreitä valintamerkkejä, kaikki on asennettu.

Tällä asennustavalla tiedostot tallennetaan sijaintiin %LOCALAPPDATA%\hermes. Jos käytät WSL2:ta, myös seuraavan osion Linux-komento toimii siellä – valitse itsellesi sopivampi tapa.

Hermes Agentin asentaminen macOS:ään ja Linuxiin#

Hermes asentuu yhdellä komennolla – kannettavaan tietokoneeseen tai palvelimelle. Näin se tapahtuu:

1. Tarkista, että Git on asennettu

   git --version
   

   Jos komento palauttaa versionumeron, jatka eteenpäin. Tarkista Linuxissa myös, että curl ja xz-utils ovat asennettuina: Debianissa ja Ubuntussa asenna ne komennolla sudo apt install curl xz-utils.

2. Suorita asennusohjelma

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

   Komentosarja kloonaa arkiston hakemistoon ~/.hermes/hermes-agent, luo virtuaaliympäristön ja asentaa hermes-komennon hakemistoon ~/.local/bin. Palvelinta varten, jossa ei ole graafista käyttöliittymää eikä selaimen automaatiota tarvita, on kevyt vaihtoehto: lisää loppuun bash -s -- --skip-browser.

3. Lataa komentotulkki uudelleen ja käynnistä

   source ~/.zshrc   # on macOS; on Linux, more often: source ~/.bashrc
   hermes
   

Kun asennat pääkäyttäjänä, tiedostot sijoitetaan järjestelmän hakemistoihin – /usr/local/lib/hermes-agent ja /usr/local/bin/hermes – mikä on kätevää usean tilin palvelimella. Asetukset, avaimet ja muisti sijaitsevat silti kunkin käyttäjän omassa ~/.hermes-hakemistossa.

Huomio Hermes Desktopista Linuxissa: sovelluksen rakentamiseen Debianissa ja Ubuntussa tarvitset build-essential-paketin kääntäjät (sudo apt install build-essential). Jos asensit Hermeksen komennolla, erillistä asennusohjelmaa ei tarvita – suorita hermes desktop, niin sovellus käynnistyy nykyisillä asetuksilla, istunnoilla ja taidoilla.

Mallin yhdistäminen Hermes Agentiin#

Malli on Hermeksen moottori: agentti ei ajattele itsenäisesti, vaan ottaa yhteyttä valitsemaasi malliin. Siksi ensimmäinen vaihe asennuksen jälkeen on valita, mihin se yhdistää:

hermes model

Asennusvelho kysyy palveluntarjoajaa, kirjautumistapaa ja mallia. Vaihtoehtoja on paljon; tärkeimmät ovat:

Jos valitset Nous Portalin, yksi komento hoitaa kaiken kerralla:

hermes setup --portal

Se avaa kirjautumissivun selaimessa. Kun vahvistat kirjautumisen, se asettaa Nousin palveluntarjoajaksi ja ottaa käyttöön Tool Gatewayn – verkkohaku, kuvien luonti ja puhesynteesi toimivat ilman erillisiä avaimia kullekin palvelulle.

Hermes tallentaa avaimet ja asetukset erikseen, ja tämä on tärkeää ymmärtää alusta asti. Salaisuudet – API-avaimet ja tunnukset – tallennetaan tiedostoon ~/.hermes/.env. Tavalliset asetukset ovat tiedostossa ~/.hermes/config.yaml. Tiedostoja ei tarvitse muokata käsin: hermes config set sijoittaa jokaisen arvon automaattisesti oikeaan tiedostoon:

Etsi työkalujen käyttöoppaita Ailoot-dokumentaatiosta

Täysi asennusvelho käynnistyy komennolla hermes setup. Siinä on kolme tilaa: nopea asennus Nous Portalin kautta, täysi asennus, jossa käyt läpi jokaisen palveluntarjoajan ja työkalun itse, sekä Blank Slate – puhdas asennus, jossa kaikki olennainen pois lukien on poistettu käytöstä, jotta voit ottaa käyttöön vain tarvitsemasi.

Näin tarkistat, että Hermes Agent toimii#

Kun olet valinnut mallin, aloita keskustelu:

hermes          # classic interface
hermes --tui    # modern interface, with mouse support and pop-up windows

Tervetulobannerissa näkyvät valittu malli, käytössä olevat työkalut ja taidot. Älä kysy ”hei, kuka olet?” – anna sen sijaan tehtävä, jonka tulos on näkyvissä: ”näytä levyn viisi suurinta kansiota” tai ”katso nykyistä kansiota ja kerro, mikä tiedosto on projektin päätiedosto”. Jos agentti suorittaa päätekomennon ja antaa merkityksellisen vastauksen, perusasennus toimii.

Viimeinen tarkistus koskee istuntoja. Poistu keskustelusta ja palaa siihen:

hermes --continue   # or shorter: hermes -c

Sinun pitäisi palata samaan keskusteluun. Tämä tarkistaa, että istunnon muisti tallennetaan levylle – myöhemmin sekä botti että ajastetut tehtävät tarvitsevat sitä.

Jos jokin ei toimi, etene tässä järjestyksessä: hermes doctor (yleinen diagnostiikka), hermes model (tarkista malli ja kirjautuminen uudelleen), hermes setup (rakenna määritys uudelleen), hermes sessions list ja hermes --continue (tarkista istunnot), hermes gateway status (gatewayn tila). Näillä toimilla voit siirtyä ”kaikki on rikki” -tilanteesta selkeään tilannekuvaan muutamassa minuutissa.

Mitä taidot ja muisti ovat Hermes Agentissa?#

Hermeksen taito on SKILL.md-tiedosto, jossa on nimi, kuvaus ja vaiheittainen ohje: miten asiakirja kootaan, pull request avataan tai postitus valmistellaan. Agentti lukee kaikkien taitojen lyhyet kuvaukset ja lataa koko tekstin vasta, kun tehtävä vastaa taitoa – näin sata asennettua taitoa ei kasvata jokaista pyyntöä. Standardi on avoin, agentskills.io, ja samat tiedostot toimivat muissa agenteissa.

Taidot sijaitsevat kansiossa ~/.hermes/skills/. Ne päätyvät sinne kolmella tavalla: perusjoukko asennetaan sovelluksen mukana, valmiita taitoja voi lisätä luettelosta komennolla hermes skills install, ja agentti kirjoittaa itselleen uusia taitoja vaativien tehtävien jälkeen. Jokaisesta taidosta tulee automaattisesti kauttaviivakomento: asenna gif-search-taito, niin /gif-search toimii missä tahansa chatissa. Luettelosta asentaminen käy läpi tietoturvatarkistuksen, jotta jonkun muun toimintatapa ei tuo mukanaan haitallisia komentoja.

Muisti on vielä yksinkertaisempi. Kaksi tiedostoa kansiossa ~/.hermes/memories/: MEMORY.md – agentin omat muistiinpanot ympäristöstään ja johtopäätöksistään, enintään 2 200 merkkiä – ja USER.md – profiilisi: miten sinulle vastataan sekä mistä pidät ja mistä et, enintään 1 375 merkkiä. Jokaisen keskustelun alussa molemmat tiedostot lisätään järjestelmäkehotteeseen, joten agentti tietää jo asioita sinusta keskustelun alkaessa. Rajat ovat tarkoituksella tiukat: muisti ei kasva hallitsemattomasti, ja agentti päättää, mitä säilyttää ja mitä hylätä.

Nämä kaksi osaa – taidot ja muisti – muodostavat Second Brainin: agentin, joka muistaa kontekstin ja kartuttaa toimintatapoja ja joka toimii huomattavasti paremmin joka viikko kuin asennuspäivänään. Ohjeita taitojen valintaan ja siihen, miten estät agenttia muuttumasta kaatopaikaksi, löydät tästä Claude Codea esimerkkinä käyttävästä oppaasta – periaatteet ovat samat.

Hermes Agentin yhdistäminen Telegramiin#

Telegram on Hermeksen suosituin kanava, ja integraatio on pitkälle kehitetty: tekstiviestit, litteroitavat ääniviestit, kuvat ja tiedostot sekä vastaukset ryhmissä. Toimi näin:

1. Luo botti BotFatherilla

   Avaa Telegramissa @BotFather, lähetä /newbot, valitse nimi ja yksilöllinen käyttäjänimi, joka päättyy sanaan bot. Saat tunnuksen, kuten 123456789:ABCdef... – se on bottisi avain, joten säilytä sitä kuin salasanaa. Jos tunnus vuotaa, peruuta se lähettämällä /revoke samalle BotFatherille.

2. Etsi käyttäjätunnuksesi

   Etsi numeerinen Telegram-tunnuksesi, esimerkiksi 123456789. Tämä on tilinumerosi; älä sekoita sitä käyttäjänimeesi. Tarvitset sitä käyttöoikeusluetteloa varten.

3. Suorita gatewayn asennusvelho

   hermes gateway setup
   

   Valitse Telegram ja liitä tunnuksesi sekä käyttäjä-ID:si. Asennusvelho tallentaa asetukset puolestasi. Voit tehdä saman manuaalisesti lisäämällä kaksi riviä tiedostoon ~/.hermes/.env: TELEGRAM_BOT_TOKEN=... ja TELEGRAM_ALLOWED_USERS=123456789.

4. Käynnistä gateway

   hermes gateway
   

   Botti tulee verkkoon muutamassa sekunnissa. Lähetä sille viesti ja tarkista vastaus.

Käyttöoikeudet ovat oletusarvoisesti suljetut: botti vastaa vain luettelossa oleville tunnuksille. Voit antaa uudelle henkilölle parituskoodin – se toimii tunnin ja vanhenee sitten. Odottavien ja hyväksyttyjen käyttäjien luettelo on saatavilla komennolla hermes pairing list.

Ryhmäkeskusteluissa on yksi usein unohtuva sudenkuoppa. Telegram-bottien yksityisyystila on oletusarvoisesti käytössä: ryhmässä botti näkee vain komennot ja vastaukset omiin viesteihinsä. Jos haluat sen lukevan kaiken, poista tila käytöstä @BotFatherissa (Bot Settings - Group Privacy) tai tee botista ryhmän ylläpitäjä, mikä on yksinkertaisempaa.

Oletusarvoisesti gateway hakee päivitykset itse Telegramin palvelimilta – tämä sopii hyvin kotitietokoneelle tai aina päällä olevalle palvelimelle. Pilvialustoille, jotka siirtävät koneen lepotilaan saapuvan liikenteen puuttuessa, on webhook-tila, jossa Telegram lähettää viestit osoitteeseesi.

Mitä muuta Hermes Agentilla voi tehdä asennuksen jälkeen?#

Tässä ovat käyttöön otettavat ominaisuudet järjestyksessä:

1. Ajastetut tehtävät. Gatewayssa on sisäänrakennettu ajastin: ”Kokoa joka aamu kello 8 uutiskatsaus aiheistani ja lähetä se minulle Telegramissa.” Määritä aikataulu tavallisella lauseella, niin tulokset saapuvat samaan chattiin.
2. Hermes Desktop. Komento hermes desktop avaa saman agentin sovelluksen macOS:lle, Windowsille ja Linuxille: vastaukset näkyvät suoratoistona, tiedostojen esikatselut chatin vieressä, asiakirjoja voi vetää ja pudottaa, ja mukana on kontekstilaskuri. Istunnot ovat yhteisiä – voit aloittaa päätteessä ja jatkaa ikkunassa.
3. Verkkohallintapaneeli. hermes dashboard avaa selaimessa paneelin kanaville, muistille, webhookeille ja profiileille. Hyödyllinen, kun Hermes toimii palvelimella.
4. Aliagentit. Voit antaa suuren tehtävän eristettyjen apuagenttien hoidettavaksi – jokaisella on oma keskustelu ja pääte, joten ne eivät kuluta kontekstiasi.
5. Puhe. Puhetila toimii päätteessä, Telegramissa ja Discordissa – voit sanella tehtävän ja saada puhutun vastauksen.
6. Koodieditori. ACP-protokollan kautta Hermes yhdistyy VS Codeen, Zediin ja JetBrainsiin suoraan editorissa toimivana agenttina.

Työkaluja voi ottaa käyttöön ja poistaa käytöstä yksi kerrallaan komennolla hermes tools, jotta agentin ei tarvitse kantaa kaikkea mukanaan. Kun on aika siirtyä toiselle koneelle, hermes backup kokoaa koko asennuksen arkistoon ja hermes import purkaa sen uudessa sijainnissa.

Kenelle Hermes Agent sopii ja kenen kannattaa odottaa?#

Hermes kannattaa asentaa, kun tiedät, mitä haluat agentin tekevän: käyvän läpi asiakirjoja, rakentavan prototyypin, hoitavan kirjeenvaihtoa tai valmistelevan aamukatsauksia. Itse työkalu ei ole tärkein asia – tärkeimpiä ovat sille antamasi tehtävät. Aiheesta on erillinen opas tekoälyagentille annettavista tehtävistä.

Se ei ehkä sovi kahdessa tapauksessa. Ensinnäkin, jos odotat, että ”rekisteröidyt ja kaikki toimii”: Hermes täytyy asentaa ja yhdistää malliin. Siihen tarvitaan vain yksi komento, mutta pääte täytyy silti avata. Toiseksi, jos sinulla ei ole sopivaa mallia etkä halua selvittää tilauksen tai API-avainten käyttöä.

Kaikkien muiden kannattaa aloittaa pienestä: asenna se, valitse malli, käy yksi sujuva keskustelu, lisää sitten Telegram-botti ja vasta sen jälkeen aikataulut ja aliagentit.

Mitä muuta ihmiset kysyvät Hermes Agentista?#

Lisää resursseja on saatavilla Ailootissa.