Hermes Agent & Hedonist Orchestrator

1. Vue d'ensemble du concept et problème systémique

La plupart des idées, des liens à explorer et des tâches opérationnelles surgissent chez le développeur ou le fondateur en déplacement — via son smartphone. Cependant, l'infrastructure de travail (serveurs, bases de code, notes locales Obsidian, terminaux) reste attachée au laptop professionnel :

1. Seuil élevé pour démarrer les routines : Pour lancer un parsing d'actualités ou vérifier le statut d'une sauvegarde sur le serveur, il faut ouvrir le laptop, se connecter via SSH et exécuter les scripts manuellement.
2. Fragmentation du flux entrant : Les liens se perdent dans la section « Sauvegardés » des messageries sans analyse ni catégorisation.
3. Dépendance aux solutions SaaS tierces : L'utilisation de services commerciaux n'offre pas un contrôle total sur les clés système et les données privées.

Hermes Agent & Hedonist Orchestrator créent un pont numérique souverain : vous interagissez avec votre infrastructure personnelle et les modèles d'intelligence artificielle avancés via l'interface familière de Telegram, aussi naturellement qu'avec un collègue dans un chat.

2. Taxonomie architecturale et modèle mental

L'architecture est construite selon un principe modulaire avec quatre couches isolées :

• 1. Passerelle d'authentification et de routage (Hedonist Gateway) : Point d'entrée pour les événements Webhook de Telegram. Elle effectue une vérification stricte de la liste blanche ALLOWED_TELEGRAM_USER_IDS et des signatures cryptographiques. Elle agit comme un dispatcher : elle analyse le texte/audio entrant via un modèle rapide (Gemini Flash ou Claude Haiku) et détermine le pipeline cible.
• 2. Noyau agentique d'exécution (Hermes Core) : Un worker autonome ayant accès aux outils : appels curl/bash, web scraping, interaction avec les dépôts Git et génération de code.
• 3. Couche de connaissances et de contexte long terme (Knowledge Vault) : Un stockage local de fichiers Markdown (synchronisé avec le coffre personnel Obsidian), une base de faits relationnelle SQLite et des index vectoriels pour la recherche sémantique.
• 4. Sous-système de notifications et de feedback (Feedback Loop) : Formatage des réponses en Telegram MarkdownV2 propre avec des boutons Inline interactifs pour confirmer les actions critiques (Human-in-the-Loop).

3. Pipeline technique et mécanique interne

Le cycle de vie de l'exécution d'une commande se déroule comme suit :

1. Ingress & Authentication (Réception et vérification) : Telegram envoie un payload JSON sur un endpoint HTTPS sécurisé. Hedonist vérifie l'User ID. Si la requête provient d'un utilisateur non autorisé, elle est immédiatement rejetée (Drop without response) pour éviter le scanning.
2. Intent Parsing & Context Fetching (Analyse de l'intention) : L'orchestrateur classe la tâche (par exemple : cmd:server_health, digest:url_scrape, note:create). S'il s'agit d'une recherche, des notes pertinentes et le contexte des sessions précédentes sont récupérés depuis le Knowledge Vault.
3. Execution & Sandboxed Processing (Exécution de la tâche) : Hermes lance le script approprié ou forme une requête vers le LLM au sein d'un conteneur Docker isolé. Les opérations longues passent en mode asynchrone avec envoi du statut typing ou d'un message intermédiaire.
4. Delivery & State Commit (Réponse et fixation de l'état) : L'utilisateur reçoit une réponse structurée avec les thèses clés, et l'artefact créé (note, rapport ou diff de code) est automatiquement commité dans le dépôt Git local.

4. Scénarios d'ingénierie pratiques en production

01. Console DevOps mobile pour le serveur 24/7

Vous remarquez une alerte de pic de charge sur le VPS. En envoyant un court message au bot, vous obtenez la sortie de docker stats, le statut des services en temps réel et un bouton « Redémarrer Nginx », sans ouvrir le terminal.

02. Deep Research et préparation automatique de digests

Vous envoyez dans le chat Telegram un lien vers un PDF de 50 pages ou un article. Hermes Agent charge la page en mode headless, extrait le contenu sans publicité, synthétise les insights architecturaux majeurs et les ajoute à la file de publication de votre canal ou blog.

03. Synchronisation bidirectionnelle des pensées avec Obsidian

Un message vocal émis en déplacement est transcrit, structuré par le modèle en thèses, catégorisé par tags et enregistré sous forme de nouveau fichier dans le dossier Daily Notes du dépôt personnel avec un git push automatique.

5. Pièges, erreurs courantes et sécurité

• Risque d'accès non autorisé (Open Bot Risk) : Si le bot ne possède pas une liste d'ID autorisés strictement hardcodée dès la première ligne du handler, un utilisateur tiers pourrait ordonner la suppression de la base de données.
• Blocage de l'Event Loop par des requêtes LLM longues : Attendre de manière synchrone la réponse du modèle pendant 30 secondes bloque le traitement des messages provenant d'autres triggers ou timeouts. Toutes les interactions doivent être purement asynchrones (async/await ou files de tâches).
• Erreurs de parsing Telegram Markdown : Des caractères tels que _, *, [, ] dans la sortie de code cassent souvent le rendu de l'API Telegram Bot (erreur Bad Request: can't parse entities). Il est nécessaire d'utiliser une fonction de sanitization robuste ou d'envoyer le code brut dans des blocs pre.