Vous installez Hermes sur une nouvelle machine, ou vous voulez simplement vous faire une idée avant d’acheter une clé API quelque part. L’ancien enchaînement était invariable : lancer hermes setup, créer un compte sur la console d’un provider, copier la clé, la coller — quinze minutes de configuration avant d’avoir dit un seul mot à l’agent.

Cette étape est désormais optionnelle. Hermes met en place une identité Nous gratuite au démarrage, ce qui vous permet de lui parler tout de suite sur un modèle par défaut, et de vous connecter plus tard, quand vous voulez réellement le catalogue complet et les outils payants.

Ce qui se passe sans rien avoir configuré

Au premier démarrage, Hermes passe quelques secondes à mettre en place l’offre gratuite, affiché sous la forme « Setting up free inference… ». Ensuite :

• l’inférence tourne sur un seul modèle, nous/welcome ;
• la bannière et hermes auth status affichent Nous · free tier · nous/welcome ;
• hermes model liste une ligne Nous · free tier avec ce seul modèle.

Aucun assistant n’apparaît et rien n’est imposé. hermes setup reste disponible chaque fois que vous voulez configurer un provider qui vous est propre.

Une réserve : l’offre gratuite est encore en cours de déploiement. Tant qu’elle n’est pas active pour tout le monde, rien de tout cela ne se produit si le processus n’a pas été démarré avec HERMES_GUEST_ONBOARDING=1 dans son environnement — et notez que la variable n’accepte que 1 ; true ne compte pas. Sans cette variable, une installation neuve se comporte exactement comme avant : le sélecteur de provider au premier lancement.

Ce que l’offre gratuite vous donne, et ce qu’elle ne donne pas

	Offre gratuite	Après connexion
Inférence	nous/welcome (un modèle)	Catalogue complet de modèles Nous Portal
Connectors (Gmail, Linear, Notion, …)	Oui	Oui
Outils payants (recherche web, génération d’images, TTS, navigateur cloud)	Non	Oui, facturés sur votre abonnement
Crédits ou solde	Aucun	Oui

Les « connectors » sont les comptes tiers que vous liez sur le portail Nous pour que l’agent puisse agir à l’intérieur. Ils fonctionnent sur l’offre gratuite sans aucune connexion — ce qui explique en grande partie pourquoi l’offre gratuite existe.

Le travail de fond tourne sur le même modèle : la compaction des conversations, les titres de chat, la compréhension d’images et autres tâches de maintenance passent tous par nous/welcome.

L’offre gratuite est le dernier recours, jamais une préférence. Tout provider que vous configurez l’emporte :

Vous avez	L’inférence tourne sur	Connectors
Rien	Offre gratuite Nous (nous/welcome)	Offre gratuite
Une clé API dans .env (OpenRouter, OpenAI, Anthropic, …)	Votre clé	Offre gratuite
model.provider défini dans config.yaml	Ce provider	Offre gratuite
Une connexion Nous Portal	Nous Portal	Votre compte

Une installation qui possède déjà un provider met quand même en place l’offre gratuite une fois au démarrage, pour que les connectors aient de quoi s’authentifier ; votre provider continue de faire l’inférence, et un avis unique vous en informe.

Deux détails qui prêtent facilement à confusion. Si model.default dans config.yaml nomme autre chose alors que l’offre gratuite fait l’inférence, Hermes utilise nous/welcome malgré tout et le dit en une ligne. Et si vous demandez un modèle que l’offre gratuite ne peut pas servir, il ne bascule pas en silence — il vous oriente :

gpt-5 needs a Nous account or an API key. Use /login to sign in, or /model to pick another provider.

Appeler un outil payant affiche This needs a Nous account. Use /login to sign in. dans un chat, et nomme hermes auth upgrade dans le terminal. Le tour lui-même se poursuit sans cet outil.

Quand vous devriez vous connecter

Partout où l’offre gratuite est présente — y compris les installations qui font l’inférence avec leur propre clé — il existe deux façons d’entrer.

Depuis un chat. Envoyez /login en message direct (Telegram, Discord, Slack et d’autres ; sur Slack, utilisez /hermes login, et cela fonctionne aussi dans une session de chat CLI). Il doit s’agir d’un message direct apparié : ailleurs, Hermes répond Sign in from a direct message with Hermes. Vous recevez trois messages — le lien de consentement, le code de connexion sur sa propre ligne, puis un avis d’attente qui commence par Do not share this code. Vous pouvez continuer à discuter pendant que Hermes attend, et le résultat est poussé dans le même DM. Relancer /login remplace le code précédent.

Depuis un terminal.

hermes auth upgrade

Il affiche une URL et un code court et ouvre le navigateur, sauf si vous passez --no-browser ou si vous êtes dans une session SSH. Après confirmation dans le navigateur, le terminal indique Signed in as [email protected]. Si votre modèle par défaut était nous/welcome, une seconde ligne nomme le modèle que votre compte utilise désormais.

L’inférence passe au catalogue de votre compte, les outils payants se débloquent, et hermes auth status cesse d’afficher la ligne de l’offre gratuite. Un modèle par défaut que vous avez choisi vous-même n’est pas modifié.

Deux choses à savoir d’avance :

1. Un compte par installation. /login lie toute l’installation au compte qui approuve le code : son inférence, ses connectors, chaque chat qu’elle sert. Sur un gateway où plusieurs personnes peuvent envoyer un DM au bot, définissez allow_admin_from pour la plateforme afin que seul un opérateur puisse lancer la commande.
2. hermes auth add nous --type oauth vous connecte aussi, mais il remplace l’offre gratuite purement et simplement et ne transfère pas vos connectors. Utilisez /login, ou hermes auth upgrade, lorsque vous avez des connectors que vous voulez conserver.

Les quatre endroits où le desktop l’affiche

L’application desktop tourne sur la même offre gratuite, exposée à quatre endroits :

Où	Ce que vous voyez
Premier lancement	Un écran prêt à l’emploi : « Hermes is ready. » avec le modèle par défaut nous/welcome, un badge Free tier et Begin ; « Sign in with a Nous account instead » et « Other providers » se trouvent en dessous. Il ne s’affiche qu’une fois.
Premier lancement avec votre propre clé API déjà présente	Un bandeau unique au-dessus du composeur : « Free Nous inference and connectors are now available. » avec un sélecteur de modèle, la connexion et le rejet
Barre d’état	Une puce Nous · free tier · nous/welcome avec un badge Sign in, masquable depuis le menu contextuel de la barre
Settings › Billing	« You’re on the Nous free tier » avec un seul bouton de connexion ; le résumé indique Plan « Free tier », Model nous/welcome, Connectors « Included » — aucun solde et rien à payer

Le CLI et le desktop lisent le même état local, si bien que les avis uniques sont partagés : en voir un sur le CLI signifie que vous ne le reverrez pas sur le desktop pour cette identité, et inversement.

La désactiver

hermes config set nous.guest false

nous.guest est un réglage normal de config.yaml (par défaut true), pas une variable d’environnement. Avec ce réglage désactivé : pas d’inférence gratuite, pas de connectors sans connexion, pas de ligne d’offre gratuite dans hermes model, et une installation neuve se voit proposer hermes setup à la place. Un compte Nous connecté, vos propres clés API et tout autre provider fonctionnent exactement comme avant.

Une note de confidentialité qu’il vaut la peine d’expliciter : l’offre gratuite a besoin d’une identité pour l’authentification et la limitation de débit, donc la première fois qu’une identité est nécessaire, Hermes crée une identité anonyme sur le portail Nous et stocke le credential dans votre répertoire Hermes, partagé entre les profiles qui s’y trouvent. Elle ne contient aucune adresse e-mail, aucun nom et aucune autre donnée personnelle, et elle expire après 14 jours sans utilisation — Hermes en crée alors une nouvelle de façon transparente. Se connecter déplace vos connectors liés dans votre compte ; mettre nous.guest à false signifie qu’aucune identité n’est créée ni utilisée du tout.

Ce que signifient les erreurs

Symptôme	Ce que cela signifie	Que faire
La première commande dit It looks like Hermes isn't configured yet et propose hermes setup	L’offre gratuite n’a pas pu être mise en place en quelques secondes : hors ligne, non ouverte sur le portail, ou limitation de débit	Revenez en ligne et réessayez, ou lancez hermes setup et ajoutez un provider. Rien ne reste à moitié configuré
Nous free tier is not open on this portal.	Le portail vers lequel Hermes pointe ne propose pas l’offre gratuite (par exemple après avoir défini HERMES_PORTAL_BASE_URL)	Connectez-vous avec un compte, retirez la substitution, ou ajoutez votre propre clé
Nous free tier is rate limited; try again shortly.	Le portail limite le débit des nouvelles mises en place de l’offre gratuite	Attendez quelques minutes, ou ajoutez votre propre clé
This needs a Nous account.	Vous avez appelé un outil payant alors que vous étiez sur l’offre gratuite	/login dans un chat, hermes auth upgrade dans un terminal, ou configurez cet outil avec votre propre clé dans hermes tools
Le sélecteur n’affiche que nous/welcome sous Nous	Comportement attendu sur l’offre gratuite	Connectez-vous pour le catalogue complet, ou ajoutez la clé d’un autre provider
L’offre gratuite a cessé de fonctionner après deux semaines d’absence	L’identité anonyme a expiré et sera remplacée au prochain démarrage	Rien — relancez simplement Hermes. Les connectors liés avant l’interruption doivent être reliés à nouveau, sauf si vous vous étiez connecté

La version courte

L’offre gratuite sait ce qu’elle est : un moyen de démarrer, pas un plan à long terme. Pour quelqu’un qui essaie Hermes pour la première fois, elle supprime toutes les étapes entre l’installation et une conversation qui fonctionne. Pour quelqu’un qui a déjà un provider, elle résout discrètement l’authentification des connectors. Et quand vous avez besoin du catalogue plus large ou des outils connectés au web, une connexion d’une minute reprend là où elle s’était arrêtée.

Pour partir de zéro, consultez le guide d’installation. L’ensemble des commandes pour les comptes se trouve dans la référence hermes auth, le changement de modèle et de provider dans hermes model, et les récents changements de plateforme et de modèles dans les notes de version.