Tutorial 12: Nix- & NixOS-Setup

Willkommen zurück zu unserer Hermes-Agent-Tutorial-Serie! In diesem Beitrag gehen wir die Installation von Hermes Agent auf Nix- und NixOS-Systemen durch. Aber hier ist die Sache – die offiziellen Dokumentationen haben sich geändert, und Nix ist kein explizit unterstützter Installationspfad mehr. Keine Sorge! Du hast trotzdem Optionen, und wir behandeln alles, was du wissen musst.

Was hat sich geändert?

Das Hermes-Team hat die Installation erheblich vereinfacht. Anstatt mehrere Installationspfade zu pflegen, empfehlen sie jetzt den universellen Installer für alle – einschließlich Nix-Nutzer. Der Nix-Support ist jetzt nur noch “Best-Effort”, das heißt, es könnte funktionieren, ist aber nicht offiziell getestet oder garantiert.

Der empfohlene Weg: Universeller Installer

Für die meisten Nutzer ist der einfachste Weg, Hermes Agent zum Laufen zu bringen, der Einzeiler-Installer. Er funktioniert auf Linux, macOS, WSL2 und sogar Android (Termux):

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

Unter nativem Windows verwende stattdessen PowerShell:

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

Der Installer übernimmt alles automatisch – Python, Node.js, ripgrep, ffmpeg, das Repository-Klonen, die virtuelle Umgebung und den globalen hermes-Befehl. Am Ende kannst du direkt loslegen.

Was ist mit Nix-spezifischem Setup?

Wenn du bereits Nix verwendest (auf NixOS, macOS oder Linux), gibt es immer noch einen dedizierten Setup-Pfad mit einem Nix-Flake, einem deklarativen NixOS-Modul und optionalem Container-Modus. Schau dir den Nix- & NixOS-Setup-Leitfaden in der offiziellen Dokumentation für Details an.

Aber hier ist unser Rat: Probiere zuerst den universellen Installer aus. Er ist der offiziell unterstützte Pfad und wurde entwickelt, um “einfach zu funktionieren”.

Voraussetzungen: Halte es einfach

Bevor du den Installer ausführst, stelle sicher, dass du Folgendes hast:

Git (erforderlich auf allen Nicht-Windows-Plattformen)
curl und xz-utils auf Linux (der Installer lädt Node.js als .tar.xz-Archiv herunter)
g++ oder build-essential auf Debian/Ubuntu (nur wenn du die Desktop-App verwenden möchtest)

Das war’s! Du musst nicht Python, Node.js, ripgrep oder ffmpeg manuell installieren. Der Installer erkennt, was fehlt, und installiert es für dich.

Auf Debian/Ubuntu kannst du alles mit folgendem Befehl vorbereiten:

sudo apt install curl xz-utils build-essential

Nach der Installation

Sobald der Installer fertig ist, lade deine Shell neu und starte den Chat:

source ~/.bashrc   # oder: source ~/.zshrc
hermes             # Starte den Chat!

Konfiguration deines Setups

Nach der Installation kannst du Dinge mit dedizierten Befehlen feinjustieren:

hermes model          # Wähle deinen LLM-Anbieter und dein Modell
hermes tools          # Konfiguriere, welche Tools aktiviert sind
hermes gateway setup  # Richte Messaging-Plattformen ein
hermes config set     # Setze einzelne Konfigurationswerte
hermes config get     # Prüfe einzelne Konfigurationswerte
hermes setup          # Oder führe den vollständigen Setup-Assistenten aus

Schnellster Weg: Nous Portal

Hier ist ein Profi-Tipp: Wenn du das lästige Verwalten einzelner API-Keys überspringen möchtest, nutze das Nous Portal. Ein Abonnement deckt über 300 Modelle plus das Tool Gateway ab (Websuche, Bildgenerierung, TTS, Cloud-Browser). Starte mit einem einzigen Befehl:

hermes setup --portal

Das meldet dich an, setzt Nous als deinen Anbieter und aktiviert das Tool Gateway – alles auf einmal.

Umzug von einem anderen Rechner?

Wenn du Hermes bereits auf einem anderen Rechner nutzt, musst du nicht alles von Grund auf neu aufbauen. Stelle ein vollständiges Backup mit hermes import wieder her oder übertrage einen einzelnen Agenten mit hermes profile import. Denke daran: Ein Profil-Export schließt Anmeldedaten standardmäßig aus, ist also kein vollständiges Backup. Verwende dafür hermes backup.

Abschließende Gedanken

Auch wenn Nix kein offiziell unterstützter Installationspfad mehr ist, macht der universelle Installer das Setup einfacher denn je. Für die meisten Nutzer ist er der richtige Weg – sogar auf NixOS. Wenn du auf Probleme stößt, ist der Nix-spezifische Leitfaden immer noch als Fallback verfügbar.

Im nächsten Teil unserer Serie tauchen wir in die Konfiguration deines ersten Agenten ein. Bis dahin: Viel Spaß beim Chatten!