Avant de commencer, une chose tout de suite : Hermes Agent n'a pas de panneau web. Il n'y a pas d'écran de connexion, pas de tableau de bord avec des graphiques, rien qui n'apparaisse dans le navigateur après être entré sur le Domaine. Toute la configuration, de la clé du modèle linguistique à la connexion du bot à Telegram, s'effectue dans le terminal. Si tu cherches un chatbot prêt à l'emploi avec une interface cliquable, ce n'est pas cette application, dans le catalogue Saplo tu trouveras d'autres outils mieux adaptés. Hermes Agent est pour quelqu'un d'autre : pour un développeur ou une agence qui veut avoir son propre agent IA connecté aux messageries, sans écrire d'intégrations avec l'API du modèle à partir de zéro et sans payer d'abonnement mensuel pour une plateforme SaaS qui, de toute façon, fait la même chose à l'intérieur. Si cela décrit ta situation, voici pas à pas comment installer Hermes Agent sur Saplo.
À qui s'adresse Hermes Agent
Avant de l'installer, vérifie si cet outil correspond bien à ce que tu souhaites faire :
- Tu construis un bot pour te répondre sur Telegram, Discord ou Slack - Hermes Agent se connecte au communicateur sélectionné et discute avec les utilisateurs en ton nom, en utilisant le modèle de langage que tu indiques.
- Tu ne veux pas écrire ta propre intégration avec l'API du modèle - la gestion des webhooks, de la mise en file d'attente des messages et du maintien de la connexion avec le communicateur est déjà dans l'image Docker, il te suffit de fournir les clés.
- Tu préfères payer une seule fois pour une Box plutôt que mensuellement pour une plateforme SaaS - Hermes Agent est open source, il n'y a pas d'abonnement séparé, tu ne paies que pour la Box sur laquelle il est hébergé.
- La configuration via le terminal ne te dérange pas - si tu t'attends à un assistant dans le navigateur, cette application te décevra, ici tout se passe en SSH.
Si tu cherches un chatbot prêt à l'emploi pour le Support client avec un Panneau d'administration, consulte les autres éléments du catalogue d'applications, tu y trouveras des outils avec une interface web.
Exigences
Pour installer Hermes Agent sur Saplo, tu as besoin de :
- Une Box L ou supérieure, car la configuration initiale nécessite un accès SSH via le Terminal en ligne, que les plans inférieurs ne proposent pas.
- Un minimum de 1,5 Go de RAM libre et 8 Go d'espace disque.
- Un Domaine ou un sous-domaine
*.saploapp.plinclus dans chaque plan, où le site d'information sera hébergé (Hermes est headless, tu ne verras donc qu'un guide d'instructions sous le Domaine, pas de panneau). - Une clé API pour le modèle linguistique, que tu fourniras lors de la configuration dans le terminal, et un token de bot pour l'application de messagerie à laquelle Hermes doit se connecter.
- Tu N'as PAS besoin d'une base de données séparée, toute la configuration et l'historique des conversations sont stockés dans un volume Docker nommé.
Installation étape par étape
- Dans le Panneau Saplo, accède au Catalogue d'applications et sélectionne Hermes Agent (catégorie "Applications IA").
- Indique une Box L ou supérieure avec au moins 1,5 Go de RAM disponible et un domaine ou sous-domaine pour la page d'information.
- Confirme l'installation. Le moteur installe Docker CE s'il n'est pas encore sur la Box, télécharge l'image officielle
nousresearch/hermes-agent(environ 900 Mo) et lance le conteneur sans port HTTP exposé. Tout le Transfert reste à l'intérieur du conteneur. - Après le démarrage, le moteur vérifie si le conteneur fonctionne réellement et n'est pas tombé dans une boucle de redémarrage, au lieu de se contenter de
docker compose upsans vérification. - Sous le domaine indiqué, une page statique avec des instructions de configuration apparaît, car Hermes ne fournit pas sa propre interface web.
Première configuration
- Dans le Panneau Saplo, va dans le Terminal Online pour la Box sur laquelle tourne Hermes (nécessite un plan L ou supérieur).
- Lance l'assistant de configuration avec la commande
docker exec -it hermes-<slug> hermes setup, où<slug>est le nom de ton installation visible dans le Panneau. - Dans l'assistant interactif, fournis la clé API du modèle de langage et le jeton du bot pour le communicateur choisi (Telegram, Discord ou Slack).
- Une fois l'assistant terminé, l'agent se connecte automatiquement au communicateur, sans redémarrage supplémentaire du conteneur.
- Tu peux visualiser l'activité de l'agent en direct avec la commande
docker logs -f hermes-<slug>dans le même Terminal Online.
Hermes Agent sur Saplo vs. les alternatives
| Intégration API de modèle personnalisée | Plateforme SaaS de chatbot IA | Hermes Agent sur Saplo | |
|---|---|---|---|
| Temps de déploiement | jours pour écrire et maintenir les webhooks | heures, mais dans l'environnement d'un tiers | minutes pour l'installation, configuration en une seule commande |
| Coût récurrent | Ton temps pour maintenir le code | abonnement mensuel fixe | coût fixe de la Box, sans frais d'agent séparés |
| Où se trouvent les données de conversation | Ton infrastructure | infrastructure du fournisseur SaaS | Ta Box, dans le volume Docker |
| Panneau web | dépend de ce que tu construis toi-même | généralement oui | aucun, configuration via le terminal |
| Messageries | tu dois intégrer chaque messagerie toi-même | selon le plan du fournisseur | Telegram, Discord et Slack intégrés à l'image |
Questions fréquentes
Hermes Agent dispose-t-il d'un panneau web ? Non, l'application est headless. Sous le domaine que tu spécifieras lors de l'installation, tu ne verras qu'une page statique avec des instructions de configuration ; l'agent lui-même fonctionne dans un conteneur Docker et n'expose aucune interface dans le navigateur.
Pourquoi l'installation nécessite-t-elle le plan Box L et non un plan inférieur ? Parce que la première configuration se fait via le Terminal en ligne, c'est-à-dire l'accès SSH au conteneur, et cela n'est disponible qu'à partir du plan Box L. Sur les plans inférieurs, tu peux créer le conteneur, mais tu ne pourras pas configurer l'agent.
Quel modèle de langage Hermes Agent peut-il utiliser ?
Tu fournis ta propre clé API lors de la configuration dans l'assistant hermes setup, donc le choix du modèle dépend du fournisseur auquel tu as accès. Saplo n'impose pas de fournisseur spécifique et n'ajoute pas de frais pour les requêtes au modèle.
Où est stocké l'historique des conversations de l'agent ? Dans un volume Docker nommé sur ta Box. Ce même volume survit au nettoyage du Catalogue d'applications, donc la configuration et l'historique ne disparaissent pas lors des opérations courantes sur la Box.
Puis-je connecter Hermes Agent à plus d'un messager à la fois ?
L'assistant hermes setup te guide pas à pas dans la configuration du messager. Donc, si tu veux gérer plus d'un canal, tu relances l'assistant et tu ajoutes d'autres connexions dans le même conteneur.
Si tu veux avoir ton propre agent AI sur Telegram, Discord ou Slack sans écrire d'intégration à partir de zéro et sans abonnement SaaS, et que le terminal ne te fait pas peur, tu peux installer Hermes Agent sur Saplo en quelques minutes. Écris-nous si tu as besoin d'aide pour la première configuration.
- #Agent AI
- #AI
- #Automatisation
- #Hermes
- #Guide
