4 / 13Mon premier agent IAPartie I · 30 min de lecture

Installer Hermes Desktop

Installez sur la machine choisie à la 02. Si vous acceptez que les prompts soient traités sur un serveur distant, activez le modèle cloud gratuit maintenant. (Passez en local plus tard.)

Install path
01
Download
Desktop
02
Setup
One provider
03
Chat OK
Smoke reply
04
Doctor
Health check
05
Know paths
Profile home

Il vous faut

  • La machine de la leçon 02matériel dédié par défaut (Windows, macOS ou Linux Desktop, selon l’offre)
  • Si vous avez pris une exception : VPS prêt, ou PC personnel avec un plan d’isolation Docker
  • L’API key rangée à la leçon 02, prête à coller
Si vous avez sauté la leçon 02 : stop. Le socle, c’est une boîte dédiée — pas « le laptop qui est ouvert ».

Récupérer l’installeur

Ouvrez hermes-agent.nousresearch.com sur la machine choisie à la leçon 02 et prenez le téléchargement Desktop app pour cet OS. Il existe aussi une ligne de commande, mais l’installeur graphique est la voie plus sûre — la leçon 10 explique pourquoi envoyer un script distant dans un shell est une habitude qu’on a intérêt à ne pas prendre.

Install Desktop app est le défaut du cours. L’option terminal en dessous est pour ceux qui savent déjà pourquoi ils la veulent.

Installer Desktop (sur la machine choisie)

Les modules suivants supposent ce cockpit : chat, profils, outils, approbations, gateway et cron — sur la machine que vous avez choisie, pas sur un ordinateur du quotidien « pour l’instant ».

Verified path (2026-08-06): Desktop on dedicated hardware + free OpenRouter or OpenCode models. Cloud chats leave the host. If a wizard label moved, official docs win.
Steps · tap the number to check0/4
  1. Confirmez que la cible d’install est la machine dédiée de la leçon 02 (ou votre exception écrite).
  2. Lancez l’installeur et laissez-le finir — il télécharge les dépendances et configure la machine une fois.
  3. Exception seulement (voie PC personnel) : activez Docker / les backends terminal isolés avant les outils agressifs — ou utilisez un VPS à la place.
  4. Lancez Hermes quand la mise en place est terminée.
Seize étapes, 10–15 minutes, une fois. Les lancements suivants sautent ça. Rien ici n’attend votre saisie — si ça bloque, notez le nom de l’étape avant de réessayer.

Brancher votre modèle gratuit

Au premier lancement, Hermes demande un fournisseur de modèle. Nous Portal est proposé comme l’option recommandée en un clic — c’est un abonnement payant, et vous n’en avez pas besoin pour finir ce cours. Choisissez I have an API key et collez la clé rangée à la leçon 02.

I have an API key (en bas à droite) est la voie gratuite. Other providers ouvre la liste si vous voulez choisir OpenRouter ou OpenCode explicitement.

Choisir I have an API key ouvre la liste des fournisseurs. Trouvez celui avec lequel vous vous êtes inscrit à la leçon 02 — OpenRouter, ou OpenCode Zen si vous êtes passé par là — et collez votre clé dans sa ligne. Chaque fournisseur a sa propre ligne : une clé dans la mauvaise ligne ne marchera simplement pas. Une suffit pour commencer, et vous pourrez en ajouter d’autres quand vous voudrez.

Vous pouvez y revenir à tout moment sous Settings → Providers → API keys, c’est aussi comme ça que vous vérifiez qu’une clé a bien atterri : les fournisseurs avec une clé montrent un point plein et une valeur masquée, les autres disent encore « Paste … key ».

Les clés posées s’affichent masquées (sk-…) ; les vides invitent à coller. Seul le fournisseur que vous utilisez vraiment en a besoin d’une.

La clé en place, choisissez le modèle. Tapez free dans la recherche de modèles : Hermes filtre les voies qui ne coûtent rien — OpenCode Zen et OpenRouter en publient plusieurs. Prenez-en un et obtenez une réponse. OpenRouter et OpenCode ne s’excluent pas : ajoutez les deux si vous voulez, et les modèles gratuits de chacun apparaissent côte à côte dans cette liste. Plus de voies = plus de repli quand l’une est saturée.

Cherchez free pour filtrer la liste. Les modèles gratuits tournent et ont des limites de débit — si l’un est occupé, prenez-en un autre dans cette liste plutôt que d’abandonner la mise en place.

Premier contact

Dites bonjour et obtenez une réponse — c’est la preuve. Puis ouvrez Settings une fois (l’engrenage, en haut à droite) pour voir la disposition, et continuez.

Une réponse, c’est toute la preuve de cette leçon. L’engrenage en haut à droite ouvre Settings.
  • Providers / models — où vivent vos clés et quel modèle répond
  • Gateway / messaging — leçon 05 ; laissez fermé pour l’instant
Checklist · cet appareil0/3

Où vivent vos fichiers

Tout ce que Hermes garde, ce sont des fichiers en clair, dans le Hermes home de ce profil, sur cette machine — souvent ~/.hermes, ou sous votre AppData utilisateur sur Windows. Vous n’avez pas besoin d’y toucher aujourd’hui ; la leçon 04 vous y envoie pour écrire le fichier de personnalité.

Compagnons optionnels

Rien ici n’est obligatoire. Hermes livre un pet — une mascotte animée qui flotte sur l’app et réagit à ce que fait l’agent — sous Settings → Appearance. Choisissez-en un si ça vous plaît ; ça ne change rien au harness. Les agents de code en forme d’IDE sont optionnels aussi : ajoutez-les seulement après que Hermes marche, et seulement sous les mêmes règles d’isolation que la machine.

Settings → Appearance → Pet. Pure décoration — mentionné seulement pour que vous sachiez ce qu’est le personnage flottant quand il apparaît.

Autres façons de déployer

Autres formes de déploiement (référence)

Si vous avez besoin d’une disposition au-delà de Desktop dédié / VPS / isolation Docker, cartographiez-la exprès ou demandez de l’aide.

  • Abonnement Nous Portal — modèles + gateway d’outils sous le montage officiel Portal
  • Infra à vous — modèles locaux / auto-hébergés ; Hermes sur la même machine ou un endpoint LAN
  • Fournisseurs cloud — clés dans Providers (OpenRouter, OpenCode, et d’autres listés dans les docs)
  • Multi-machines — séparer l’UI Desktop, le gateway toujours allumé, et l’hôte de modèle
Pour une disposition multi-hôtes, équipe, ou durcie, contactez Delta V — nos ingénieurs conçoivent et livrent des montages Hermes au-delà de ce cours gratuit.

Vous avez fini quand

Preuve · cet appareil0/1

Stocké sur cet appareil seulement — n’est envoyé nulle part.