Matrix — Réseau de Chat Décentralisé | Easy Understand Hermes Agent

Matrix — Réseau de Chat Décentralisé

Si vous avez déjà rêvé d’un réseau de chat où vous n’êtes pas prisonnier du serveur de quelqu’un d’autre, Matrix est la réponse. C’est un protocole de messagerie ouvert et fédéré — pensez à l’e-mail, mais pour la messagerie instantanée. Vous pouvez héberger votre propre serveur domestique (homeserver), ou utiliser un serveur public comme matrix.org. Dans tous les cas, vous gardez le contrôle de vos conversations.

Hermes Agent s’intègre directement à Matrix grâce au SDK Python mautrix. Cela signifie que votre bot peut discuter avec vous via Matrix, en utilisant toutes les capacités d’Hermes que vous connaissez et appréciez — utilisation d’outils, mémoire, raisonnement et réponses en temps réel. Il gère le texte, les fichiers, les images, l’audio, la vidéo, et même le chiffrement de bout en bout (E2EE) en option.

Et voici le meilleur : Hermes fonctionne avec n’importe quel serveur domestique Matrix. Synapse, Conduit, Dendrite, ou le grand serveur public de matrix.org — choisissez votre préféré.

Comment Hermes se comporte

Une fois connecté, Hermes a des comportements par défaut intelligents. Voici l’essentiel :

Contexte	Comportement
Messages directs (DM)	Hermes répond à chaque message. Pas besoin de le mentionner avec @. Chaque DM a sa propre session.
Salons	Par défaut, Hermes attend une mention @ avant de répondre. Vous pouvez modifier cela avec `MATRIX_REQUIRE_MENTION=false` ou ajouter des salons spécifiques à `MATRIX_FREE_RESPONSE_ROOMS`. Les invitations aux salons sont acceptées automatiquement.
Fils de discussion (Threads)	Hermes prend entièrement en charge les fils Matrix. Répondez dans un fil, et Hermes garde ce contexte séparé de la chronologie principale du salon. Les fils où le bot a déjà participé ne nécessitent pas de mention.
Création automatique de fils	Par défaut, Hermes crée automatiquement un fil pour chaque réponse dans un salon. Cela garde les conversations ordonnées et isolées. Désactivez-le avec `MATRIX_AUTO_THREAD=false`.
Commandes	Les `/commandes` normales fonctionnent comme prévu. Si votre client réserve `/` pour les commandes locales, utilisez simplement `!commandes` à la place — Hermes normalise ces alias automatiquement.
Contrôles interactifs	Les approbations pour les commandes dangereuses et la sélection `/model` peuvent utiliser les réactions Matrix. Vous pouvez même restreindre les réactions d’approbation à l’utilisateur qui a demandé l’action.
Activité de réflexion et d’outils	Hermes utilise des panneaux filaires et modifiables pour l’activité de réflexion et d’outils lorsque la progression de la passerelle est activée. Fini l’inondation de la chronologie principale avec des mises à jour.
Salons partagés	Par défaut, Hermes isole l’historique de session par utilisateur dans un salon. Deux personnes dans le même salon ne partagent pas une seule transcription, sauf si vous désactivez explicitement cette option.

Astuce de pro : Invitez simplement l’utilisateur Matrix du bot dans n’importe quel salon, et il rejoindra et commencera à répondre automatiquement.

Ce que Hermes peut faire sur Matrix

Voici la liste complète des capacités, directement issue de la déclaration de l’adaptateur :

Texte — oui
Fils de discussion — oui
Réactions — oui
Approbations — oui
Sélecteur de modèle — oui
Panneaux de réflexion — oui
Images — oui (y compris plusieurs images)
Fichiers — oui
Voix/audio — oui
Vidéo — oui
E2EE — désactivé / optionnel / requis (selon le mode)
Diagnostics — oui

Modèle de session dans Matrix

Par défaut, Hermes garde les choses bien séparées :

Chaque DM a sa propre session
Chaque fil a son propre espace de noms de session
Chaque utilisateur dans un salon partagé a sa propre session dans ce salon

Ceci est contrôlé par config.yaml :

group_sessions_per_user: true

Mettez-le à false uniquement si vous voulez explicitement une conversation partagée pour tout le salon :

group_sessions_per_user: false

Les sessions partagées peuvent être utiles pour un salon collaboratif, mais attention : les utilisateurs partagent la croissance du contexte et les coûts de tokens, la tâche longue et gourmande en outils d’une personne peut gonfler le contexte de tout le monde, et l’exécution en cours d’une personne peut interrompre le suivi d’une autre.

Configuration des mentions et des fils

Vous pouvez tout ajuster via des variables d’environnement ou config.yaml. Voici la version YAML :

matrix:
  require_mention: true           # Exiger la mention @ dans les salons (défaut : true)
  allowed_users:                  # Utilisateurs Matrix autorisés à déclencher des tours de l'agent
    - "@alice:matrix.org"
  allowed_rooms:                  # Salons Matrix autorisés à déclencher des tours de l'agent
    - "!abc123:matrix.org"
  free_response_rooms:            # Salons exemptés de l'exigence de mention
    - "!abc123:matrix.org"
  ignore_user_patterns:           # Utilisateurs fantômes de ponts/appservices à ignorer
    - "^@telegram_"
    - "^@whatsapp_"
  process_notices: false          # Ignorer m.notice par défaut
  session_scope: room             # auto|room|thread ; room est recommandé pour les salons de projet
  auto_thread: true               # Créer automatiquement des fils pour les réponses (défaut : true)
  dm_mention_threads: false       # Créer un fil lors d'une mention @ en DM (défaut : false)
  max_message_length: 16000       # Taille des morceaux sortants en caractères (défaut : 16000, max : 65535)

Ou via des variables d’environnement :

MATRIX_REQUIRE_MENTION=true
MATRIX_ALLOWED_USERS=@alice:matrix.org
MATRIX_ALLOWED_ROOMS=!abc123:matrix.org
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org,!def456:matrix.org
MATRIX_IGNORE_USER_PATTERNS='^@telegram_,^@whatsapp_'
MATRIX_PROCESS_NOTICES=false
MATRIX_SESSION_SCOPE=room       # recommandé pour un contexte stable de salon de projet
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_REACTIONS=true          # défaut : true — réactions emoji pendant le traitement
MATRIX_ALLOW_ROOM_MENTIONS=false

Astuce : MATRIX_REACTIONS=false désactive les réactions emoji du cycle de traitement (👀/✅/❌) que le bot publie sur les messages entrants. Pratique pour les salons où les événements de réaction sont bruyants ou non pris en charge.

Autre astuce : Hermes envoie des mentions utilisateur Matrix structurées pour les identifiants explicites comme @alice:example.org. Les mentions @room à l’échelle du salon sont contrôlées séparément.

Voilà, c’est tout pour Matrix. Que vous hébergiez votre propre serveur domestique ou que vous vouliez simplement un chat décentralisé qui respecte votre vie privée, Hermes vous couvre. Allez inviter votre bot dans un salon et voyez-le en action !