Loslegen, bevor Sie einen API-Key einfügen: So funktioniert der Free Tier von Hermes – und wann Sie sich anmelden

Sie installieren Hermes auf einer neuen Maschine – oder wollen es einfach ausprobieren, bevor Sie irgendwo einen API-Key kaufen. Die alte Reihenfolge war: hermes setup ausführen, sich in irgendeiner Provider-Konsole registrieren, den Key kopieren, einfügen – fünfzehn Minuten Setup, bevor Sie dem Agenten auch nur ein Wort gesagt hatten. Dieser Schritt ist jetzt optional: Hermes legt beim Start eine kostenlose Nous-Identität an, sodass Sie sofort auf einem Standardmodell mit ihm reden und sich später anmelden können, wenn Sie den vollen Katalog und die bezahlten Tools wirklich wollen.
Was passiert, wenn nichts konfiguriert ist
Beim ersten Start verbringt Hermes ein paar Sekunden mit dem Einrichten des Free Tiers, angezeigt als „Setting up free inference…“. Danach:
- Die Inferenz läuft auf einem einzigen Modell namens
nous/welcome; - Banner und
hermes auth statuszeigenNous · free tier · nous/welcome; hermes modellistet eine Zeile Nous · free tier mit genau diesem einen Modell.
Kein Wizard erscheint und nichts wird erzwungen. hermes setup bleibt verfügbar, wann immer Sie einen eigenen Provider konfigurieren wollen.
Eine Einschränkung: Der Free Tier wird noch ausgerollt. Solange er nicht für alle aktiv ist, passiert nichts davon, wenn der Prozess nicht mit HERMES_GUEST_ONBOARDING=1 in seiner Umgebung gestartet wurde – und Achtung: Die Variable akzeptiert nur 1; true zählt nicht. Ohne sie verhält sich eine frische Installation exakt wie zuvor: mit dem Provider-Picker beim ersten Start.
Was der Free Tier bietet – und was nicht
| Free Tier | Nach der Anmeldung | |
|---|---|---|
| Inferenz | nous/welcome (ein Modell) |
Vollständiger Modellkatalog des Nous Portal |
| Connectoren (Gmail, Linear, Notion, …) | Ja | Ja |
| Bezahlte Tools (Websuche, Bilderzeugung, TTS, Cloud-Browser) | Nein | Ja, über Ihr Abo abgerechnet |
| Credits oder Guthaben | Keine | Ja |
„Connectoren“ sind die Drittanbieter-Accounts, die Sie im Nous Portal verknüpfen, damit der Agent darin handeln kann. Sie funktionieren im Free Tier ohne jede Anmeldung – was ein großer Teil des Grundes ist, warum es den Free Tier überhaupt gibt.
Auch Hintergrundarbeit läuft auf demselben Modell: Konversations-Kompaktierung, Chat-Titel, Bildverständnis und ähnliche Hausmeisterei laufen alle über nous/welcome.
Der Free Tier ist die letzte Option, nie die Präferenz. Jeder Provider, den Sie konfigurieren, gewinnt:
| Sie haben | Inferenz läuft auf | Connectoren |
|---|---|---|
| Nichts | Nous Free Tier (nous/welcome) |
Free Tier |
Einen API-Key in .env (OpenRouter, OpenAI, Anthropic, …) |
Ihrem Key | Free Tier |
model.provider in config.yaml gesetzt |
Diesem Provider | Free Tier |
| Eine Anmeldung im Nous Portal | Nous Portal | Ihrem Account |
Eine Installation, die bereits einen Provider hat, richtet den Free Tier beim Start trotzdem einmal ein, damit die Connectoren etwas zur Authentifizierung haben; Ihr Provider macht weiterhin die Inferenz, und ein einmaliger Hinweis sagt Ihnen das.
Zwei Details, die leicht für Verwirrung sorgen. Wenn model.default in config.yaml etwas anderes nennt, während der Free Tier die Inferenz macht, nutzt Hermes trotzdem nous/welcome und sagt das in einer Zeile. Und wenn Sie ein Modell anfragen, das der Free Tier nicht bedienen kann, schaltet er nicht still um – er weist Ihnen einen Weg:
gpt-5 needs a Nous account or an API key. Use /login to sign in, or /model to pick another provider.
Beim Aufruf eines bezahlten Tools erscheint im Chat This needs a Nous account. Use /login to sign in. und im Terminal wird hermes auth upgrade genannt. Der Turn selbst läuft ohne das Tool weiter.
Wann Sie sich anmelden sollten
Wo immer der Free Tier vorhanden ist – auch bei Installationen, die Inferenz über einen eigenen Key fahren – gibt es zwei Wege hinein.
Aus einem Chat. Senden Sie /login in einer Direktnachricht (Telegram, Discord, Slack und andere; bei Slack /hermes login, und es funktioniert auch in einer CLI-Chat-Session). Es muss eine gepaarte Direktnachricht sein: andernfalls antwortet Hermes Sign in from a direct message with Hermes. Sie erhalten drei Nachrichten – den Consent-Link, den Anmeldecode in einer eigenen Zeile, dann einen Wartehinweis, der mit Do not share this code. beginnt. Sie können weiterchatten, während Hermes wartet, und das Ergebnis wird in dieselbe DM geschoben. Ein erneutes /login ersetzt den vorherigen Code.
Aus einem Terminal.
hermes auth upgrade
Es gibt eine URL und einen kurzen Code aus und öffnet den Browser, sofern Sie nicht --no-browser übergeben oder sich in einer SSH-Session befinden. Nach Ihrer Bestätigung im Browser meldet das Terminal Signed in as [email protected]. War Ihr Standardmodell nous/welcome, nennt eine zweite Zeile das Modell, das Ihr Account jetzt verwendet.
Die Inferenz wechselt in den Katalog Ihres Accounts, bezahlte Tools werden freigeschaltet, und hermes auth status zeigt die Free-Tier-Zeile nicht mehr. Ein selbst gewähltes Standardmodell bleibt unangetastet.
Zwei Dinge, die Sie vorher wissen sollten:
- Ein Account pro Installation.
/loginbindet die gesamte Installation an den Account, der den Code bestätigt: seine Inferenz, seine Connectoren, jeden Chat, den sie bedient. Auf einem Gateway, an dem mehrere Leute den Bot per DM anschreiben können, setzen Sieallow_admin_fromfür die Plattform, damit nur ein Operator ihn ausführen kann. hermes auth add nous --type oauthmeldet Sie ebenfalls an, ersetzt aber den Free Tier komplett und übernimmt Ihre Connectoren nicht. Nutzen Sie/loginoderhermes auth upgrade, wenn Sie Connectoren behalten wollen.
Die vier Stellen, an denen die Desktop-App ihn zeigt
Die Desktop-App läuft auf demselben Free Tier und zeigt ihn an vier Stellen:
| Wo | Was Sie sehen |
|---|---|
| Erster Start | Ein Ready-Screen: „Hermes is ready.“ mit dem Standardmodell nous/welcome, einem Free-tier-Badge und Begin; darunter stehen „Sign in with a Nous account instead“ und „Other providers“. Er erscheint nur einmal. |
| Erster Start mit bereits vorhandenem eigenem API-Key | Ein einmaliger Streifen über dem Composer: „Free Nous inference and connectors are now available.“ mit Modell-Picker, Anmeldung und Ausblenden |
| Statusleiste | Ein Chip Nous · free tier · nous/welcome mit Sign-in-Badge, ausblendbar über das Rechtsklick-Menü der Leiste |
| Settings › Billing | „You’re on the Nous free tier“ mit einer einzigen Anmelde-Schaltfläche; die Zusammenfassung zeigt Plan „Free tier“, Model nous/welcome, Connectors „Included“ – kein Guthaben und nichts zu bezahlen |
CLI und Desktop lesen denselben lokalen State, die einmaligen Hinweise werden also geteilt: Sehen Sie einen in der CLI, erscheint er für diese Identität nicht erneut im Desktop – und umgekehrt.
Abschalten
hermes config set nous.guest false
nous.guest ist eine normale Einstellung in config.yaml (Standard true), keine Umgebungsvariable. Ausgeschaltet gilt: keine kostenlose Inferenz, keine anmeldefreien Connectoren, keine Free-Tier-Zeile in hermes model, und einer frischen Installation wird stattdessen hermes setup angeboten. Ein angemeldeter Nous-Account, Ihre eigenen API-Keys und jeder andere Provider funktionieren exakt wie zuvor.
Eine Datenschutz-Anmerkung, die explizit sein sollte: Der Free Tier braucht eine Identität für Authentifizierung und Rate Limiting, deshalb legt Hermes beim ersten Bedarf eine anonyme Identität im Nous Portal an und speichert das Credential in Ihrem Hermes-Verzeichnis, geteilt über die darunter liegenden Profile. Sie enthält keine E-Mail-Adresse, keinen Namen und keine sonstigen personenbezogenen Daten und läuft nach 14 Tagen ohne Nutzung ab – Hermes legt transparent eine neue an. Eine Anmeldung überführt Ihre verknüpften Connectoren in Ihren Account; nous.guest auf false bedeutet, dass gar keine Identität angelegt oder verwendet wird.
Was die Fehlermeldungen bedeuten
| Symptom | Was es bedeutet | Was zu tun ist |
|---|---|---|
Der erste Befehl meldet It looks like Hermes isn't configured yet und bietet hermes setup an |
Der Free Tier konnte nicht innerhalb weniger Sekunden eingerichtet werden: offline, im Portal nicht offen oder rate limited | Wieder online gehen und erneut versuchen oder hermes setup ausführen und einen Provider hinzufügen. Nichts bleibt halb konfiguriert |
Nous free tier is not open on this portal. |
Das Portal, auf das Hermes zeigt, bietet den Free Tier nicht an (etwa nach dem Setzen von HERMES_PORTAL_BASE_URL) |
Mit einem Account anmelden, das Override entfernen oder einen eigenen Key hinzufügen |
Nous free tier is rate limited; try again shortly. |
Das Portal drosselt neue Free-Tier-Einrichtungen | Ein paar Minuten warten oder einen eigenen Key hinzufügen |
This needs a Nous account. |
Sie haben im Free Tier ein bezahltes Tool aufgerufen | /login im Chat, hermes auth upgrade im Terminal oder das Tool mit Ihrem eigenen Key in hermes tools konfigurieren |
Der Picker zeigt unter Nous nur nous/welcome |
Erwartetes Verhalten im Free Tier | Anmelden für den vollen Katalog oder den Key eines anderen Providers hinzufügen |
| Der Free Tier funktioniert nach zwei Wochen Pause nicht mehr | Die anonyme Identität ist abgelaufen und wird beim nächsten Start ersetzt | Nichts – starten Sie Hermes einfach neu. Connectoren, die vor der Pause verknüpft wurden, müssen erneut verknüpft werden, sofern Sie nicht angemeldet waren |
Die Kurzfassung
Der Free Tier weiß, was er ist: ein Weg, in Gang zu kommen, kein Langzeitplan. Für jemanden, der Hermes zum ersten Mal ausprobiert, entfallen alle Schritte zwischen der Installation und einem funktionierenden Gespräch. Für jemanden, der bereits einen Provider hat, löst er still die Connector-Authentifizierung. Und wenn Sie den größeren Katalog oder webfähige Tools brauchen, übernimmt eine Anmeldung in einer Minute genau dort, wo er aufgehört hat.
Für einen Start von Null siehe die Installationsanleitung. Die vollständige Befehlsfläche für Accounts steht in der hermes auth-Referenz, Modell- und Provider-Wechsel in hermes model, und aktuelle Plattform- und Modelländerungen in den Release Notes.