Voorbereiding

Tijd: 10 minuten

Doel: je weet op welke machine je agent straks leeft.

Vier routes. Ze leiden alle vier naar hetzelfde resultaat.

Voor de workshop werkt elke route. Alleen bij blok 5 merk je verschil: op A en B draait je agent alleen als je laptop aanstaat. Prima voor vandaag, en je kunt later verhuizen zonder iets opnieuw te bouwen.

Wat je doet

Zoek hieronder je route op en volg de stappen. Sla de rest over.

Route A: de terminal, op een Mac

Reken op: vijf tot tien minuten.

1. Open Terminal. Druk op Cmd + spatie. Er verschijnt een zoekbalkje in het midden van je scherm. Typ terminal en druk op Enter. Er opent een venster met witte of zwarte achtergrond en een knipperende cursor. Dat is je terminal.

2. Plak de installatieregel. Selecteer de regel hieronder, kopieer hem met Cmd + C, klik in het terminalvenster en plak met Cmd + V.

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

3. Druk op Enter. Er begint tekst over je scherm te lopen. Dat hoort zo. Je hoeft niets te doen en niets te lezen.

4. Wacht. Twee tot tien minuten, afhankelijk van je verbinding. De installatie haalt alles op wat nodig is. Ga niet klikken, laat hem zijn gang gaan.

Wat je onderweg ziet: regels over downloaden, uitpakken en installeren. Soms een waarschuwing in het geel. Dat is meestal onschuldig. Alleen rode tekst met het woord error is een probleem.

5. Sluit het terminalvenster helemaal. Niet minimaliseren, echt sluiten met Cmd + Q. Dit is de stap die iedereen vergeet en die de meeste problemen veroorzaakt.

6. Open een nieuw terminalvenster (zie stap 1) en typ:

hermes

Wat je nu moet zien: een begroeting en een regel waar je kunt typen. Je bent binnen.

Gaat het mis?

Route A: de terminal, op Windows

Reken op: vijf tot vijftien minuten. Op Windows duurt het vaker wat langer.

1. Open PowerShell. Klik op de Startknop, typ powershell, en klik op Windows PowerShell in de resultaten. Er opent een blauw venster met witte tekst.

2. Plak de installatieregel. Kopieer de regel hieronder. Klik in het blauwe venster en druk op je rechtermuisknop. In PowerShell plakt de rechtermuisknop, Ctrl + V werkt niet altijd.

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

3. Druk op Enter.

4. Wacht. Vijf tot vijftien minuten. Er loopt tekst over je scherm. De installatie regelt alles zelf, inclusief een eigen afgeschermde versie van Git die niets aan je systeem verandert.

5. Let op je antivirus. Ongeveer een op de drie Windows-gebruikers krijgt hier een melding. Zie het kader onderaan deze stap. Los dat op voordat je verdergaat.

6. Sluit PowerShell helemaal en open het opnieuw.

7. Typ:

hermes

Wat je nu moet zien: een begroeting en een regel waar je kunt typen.

Gaat het mis?

Route B: de desktopapp, op een Mac

Reken op: vijf tot tien minuten.

Controleer eerst je Mac. Dit is belangrijk. Klik linksboven op het Apple-logo en kies Over deze Mac.

• Staat er bij Chip iets met Apple M1, M2, M3 of M4? Ga door.
• Staat er Intel? Dan werkt de desktopapp niet op jouw machine. Ga terug naar route A. Dat is geen ramp, alles in dit boek werkt daar ook.

1. Download de app. Ga naar hermes-agent.nousresearch.com en klik op de downloadknop voor macOS. Je downloadt een bestand met de naam Hermes-Setup.dmg.

2. Open het gedownloade bestand. Dubbelklik erop. Er opent een venster met het Hermes-icoon en een pijl naar je map Programma's.

3. Sleep het icoon naar Programma's. Wacht tot het kopiëren klaar is.

4. Open Hermes vanuit je map Programma's of via Cmd + spatie en de naam intypen.

5. Laat hem installeren. Bij de eerste start haalt de app het onderliggende systeem op. Dat duurt twee tot drie minuten en je ziet een voortgangsscherm. Laat hem rustig zijn gang gaan.

6. Je komt in een instelscherm. Daar kies je je model. Dat is stap V2 hieronder.

Gaat het mis?

Goed om te weten: deze installatie zet de terminalversie er meteen bij. Je hebt dus allebei, en ze delen dezelfde instellingen, hetzelfde geheugen en dezelfde werkwijzen.

Route B: de desktopapp, op Windows

Reken op: vijf tot tien minuten.

1. Download de app. Ga naar hermes-agent.nousresearch.com en klik op de downloadknop voor Windows. Je downloadt Hermes-Setup.exe.

2. Dubbelklik op het bestand.

3. Windows SmartScreen geeft een waarschuwing. Er verschijnt een blauw scherm met "Windows heeft uw pc beschermd". Dat is normaal bij nieuwe software.

Klik op Meer informatie (kleine link, makkelijk te missen) en daarna op Toch uitvoeren.

4. Volg het installatieprogramma. Klik door de stappen. Je hebt geen beheerdersrechten nodig.

5. Start Hermes. Bij de eerste keer haalt de app het onderliggende systeem op. Twee tot drie minuten.

6. Je komt in een instelscherm. Daar kies je je model. Dat is stap V2.

Gaat het mis?

Route C: een virtuele server bij Hostinger

Reken op: vijftien tot dertig minuten, inclusief het bestellen.

Deze route heeft geen terminal nodig. Je klikt hem in elkaar.

1. Bestel een VPS. Ga naar Hostinger en kies een VPS-pakket. Een instapper met 2 vCPU en 4 GB geheugen is genoeg, vijf tot vijftien euro per maand. Kies Ubuntu 24.04 als besturingssysteem als daarom wordt gevraagd.

2. Wacht tot de server klaar is. Dat duurt een paar minuten. Je krijgt een bericht of je ziet het in je dashboard.

3. Open je VPS-dashboard. Klik op je server in de lijst.

4. Ga naar Docker Manager. In het linkermenu of op het overzicht. Klik daarna op Catalog.

5. Zoek Hermes Agent. Typ hermes in het zoekveld. Klik op Select bij Hermes Agent.

6. Verzin een beheerdersnaam en wachtwoord. Je wordt hierom gevraagd tijdens het opzetten.

Schrijf ze hier op. Je krijgt ze niet terug.

Gebruikersnaam: ______________________

Wachtwoord: bewaar dit in je wachtwoordmanager

7. Modelsleutel invullen? Sla over. Je kunt hier al een sleutel invullen, maar dat hoeft niet. Je doet het straks bij stap V2, waar het beter is uitgelegd.

8. Klik op Deploy. Het platform zet nu alles voor je klaar. Dat duurt enkele minuten. Je ziet een voortgangsindicator.

9. Klik op Open. Als de installatie klaar is, staat er naast je Hermes-project een knop Open. Die brengt je direct in Hermes, in je browser.

10. Loop de instelprocedure door. De eerste keer verschijnt een tekstmenu. Navigeer met de pijltjestoetsen, kies met Enter of de spatiebalk.

Kies Full setup als je je eigen modelsleutel gaat gebruiken, of Quick Setup als je via Nous Research wilt werken.

Kijk eerst of je AI-credits hebt. Sommige VPS-pakketten bevatten credits waarmee je via één toegangspunt bij meerdere modellen kunt. Staat dat in je dashboard, gebruik dat dan. Dan hoef je geen losse accounts aan te maken.

Let op bij deze route. Je Obsidian-vault staat straks op je laptop en je agent op die server. Dat is op te lossen, maar niet vanzelf. Lees de bijlage achterin voordat je hiervoor kiest.

Gaat het mis?

Route D: gehost, zonder eigen server

Reken op: vijf tot tien minuten.

1. Kies je aanbieder. Ga naar portal.nousresearch.com voor de variant van de makers zelf, of neem een beheerde Hermes bij je hoster.

2. Neem een abonnement.

3. Kies "Deploy in the cloud" of de vergelijkbare optie bij je aanbieder.

4. Volg hun instelprocedure. Je hoeft niets te installeren. Zij beheren de machine.

5. Noteer waar je agent straks te bereiken is:

Let op bij deze route. Ook hier geldt de waarschuwing over je vault uit de bijlage achterin.

Twee dingen die voor elke route gelden

Je kunt combineren. Veel mensen hebben de desktopapp op hun laptop én een agent op een server. Voor vandaag is één genoeg.

De desktopapp kan ook een agent elders aansturen. Kies je later route C of D, dan kun je de app alsnog op je laptop zetten en hem naar die server laten kijken. Je krijgt dan het comfortabele scherm lokaal terwijl het werk elders gebeurt.

Klaar als

• Je weet welke route je hebt gekozen: ______
• De installatie is doorlopen zonder foutmeldingen
• Je ziet een Hermes-venster of een Hermes-prompt op je scherm

Let op: de drie struikelblokken

Antivirus op Windows. Je antivirus denkt soms dat een onderdeel van de installatie malware is. Dat is een bekende valse melding. Geef de map %LOCALAPPDATA%\hermes\bin een uitzondering in je antivirusprogramma. De map, niet het bestand, want dat verandert bij elke update.

Intel-Macs. De desktopapp werkt alleen op Macs met een Apple-chip. Heb je een oudere Mac met een Intel-processor, kies dan route A.

Git op Mac. In zeldzame gevallen ontbreekt Git. Typ git --version in je Terminal. Krijg je een versienummer, dan zit je goed. Krijg je een vraag om ontwikkelaarsgereedschap te installeren, klik dan op installeren en wacht.