Hermes Agent mit DeepSeek einrichten

1. Desktop oder CLI wählen

Hermes Desktop bietet eine grafische Oberfläche für Chat und Einstellungen. Wenn Sie lieber im Terminal arbeiten, wählen Sie die CLI. Beide Varianten verwenden Hermes Agent. Eine Verbindung über die DeepSeek API lädt keine Modellgewichte auf Ihren Computer herunter.

2. API key und offizielle Downloads vorbereiten

Für eine direkte Verbindung benötigen Sie einen API key der DeepSeek API-Plattform und ausreichendes API-Guthaben. Die Anmeldung bei einer Chat-Anwendung ist kein API key. Hermes Agent ist kostenlos und Open Source; Modellaufrufe und optionale Tool-Dienste können gesonderte Kosten verursachen.

Stammt Ihr Schlüssel aus einem Coding Plan oder von einem anderen Anbieter, verwenden Sie dessen mitgelieferte Base URL und Modellanweisungen. API key, Base URL und Modell-ID müssen zusammenpassen. Senden Sie einen Coding Plan-Schlüssel nur dann an den offiziellen DeepSeek-Endpunkt, wenn die Lieferanweisungen diesen Weg ausdrücklich vorsehen.

3. CLI unter macOS, Linux oder WSL2 installieren

Verwenden Sie auf einem unterstützten System das offizielle Installationsskript. Öffnen Sie danach ein neues Terminal und prüfen Sie die Version. Wenn Sie Hermes Desktop bereits installiert haben, verwenden Sie dessen mitgelieferte Laufzeitumgebung, statt eine zweite Installation darüberzulegen.

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

# Nach der Installation in einem neuen Terminal:
hermes --version

4. CLI unter Windows installieren

Unter Windows steht ein nativer PowerShell-Installer zur Verfügung. Öffnen Sie danach ein neues Terminal und prüfen Sie die Version. WSL2 ist ein eigener Linux-Installationsweg und keine Voraussetzung für die native CLI. Die Anforderungen für Hermes Desktop finden Sie in der separaten Desktop-Anleitung.

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

# Nach der Installation in einem neuen Terminal:
hermes --version

5. DeepSeek und das Modell auswählen

Starten Sie hermes model, wählen Sie DeepSeek als Provider und geben Sie Ihren API key erst bei der entsprechenden Eingabeaufforderung ein. So landet der Schlüssel nicht in einem Befehl, den Ihr Terminal möglicherweise im Verlauf speichert.

Die DeepSeek-Integrationsanleitung beschreibt einen Quick Setup-Weg. In der aktuellen Hermes-Dokumentation bezeichnet Quick Setup jedoch den Einstieg über Nous Portal. Wenn Sie einen eigenen DeepSeek API key nutzen möchten, wählen Sie hermes model oder beim Aufruf von hermes setup die Option Full Setup. Folgen Sie der tatsächlichen Provider-Auswahl auf Ihrem Bildschirm.

hermes model

6. Erst Chat, dann einen Tool-Aufruf prüfen

Starten Sie mit dem ausgewählten Modell eine neue Sitzung und senden Sie den kurzen Testbefehl unten. Eine normale Antwort bestätigt, dass eine einfache Modellanfrage funktioniert. Sie belegt noch nicht, dass Datei-, Terminal- oder Web-Tools funktionieren.

Öffnen Sie für einen separaten Tool-Test einen kleinen Testordner und bitten Sie Hermes, die Dateinamen mit einem Datei-Tool aufzulisten, ohne etwas zu ändern oder zu löschen. Prüfen Sie die sichtbare Tool-Aktivität und vergleichen Sie das Ergebnis mit dem Ordner. Eine bloße Behauptung ohne Tool-Ereignis reicht als Test nicht aus.

hermes chat -q "Reply with exactly: connection-ok"

7. Auf der funktionierenden Einrichtung aufbauen

Behalten Sie zunächst den funktionierenden Anbieter und die Modell-ID bei. Sobald Chat und Tools getestet sind, können Sie weitere Funktionen schrittweise ergänzen, etwa wiederverwendbare Abläufe mit Skills und Memory. Vergleichen Sie andere Agenten möglichst mit demselben DeepSeek-Modell; für einen verwalteten Dienst können Sie auch Meta Muse gegenüberstellen.