Retour au blog
Hermes & TheaNovember 6, 20266 min de lecture

Deux IA. Une conversation. Dans les deux sens.

Hermes tourne sur votre machine. Thea tourne sur un serveur. Désormais, chacune peut confier un fil à l'autre, et une clé API manquante ne fait plus échouer le tour.

next-vibe tourne partout : sur votre portable, sur un VPS, sur les deux à la fois. Connectez deux instances et elles forment un seul système. Les nôtres s'appellent Hermes et Thea.

Cette version boucle la boucle : les fils distants s'exécutent désormais dans les deux sens, et l'instance sans clé de fournisseur ne bloque plus rien.

Le duo

Même base de code. Des rôles différents.

Local

Hermes

Tourne sur votre propre ordinateur. À côté de vos fichiers, de votre terminal et de vos agents de code. Votre outil de tous les jours.
Cloud

Thea

Tourne sur un serveur. Toujours en ligne, joignable de partout. Surveille la plateforme et délègue le travail.

Chaque instance possède ses propres données et ses propres tâches. La connexion relaie les événements entre elles. Ni plus, ni moins.

Les fils circulent maintenant dans les deux sens

Les fils des dossiers distants et privés s'exécutent sur l'autre instance : de Thea vers Hermes et de Hermes vers Thea.

Placez un fil dans un dossier distant et l'instance d'en face exécute le tour IA complet : modèle, prompt système, outils. Vous continuez d'écrire là où vous êtes. La conversation vous revient en miroir.

Un tour, de bout en bout

1

Vous écrivez

Un message dans un fil distant sur Hermes.

2

La connexion le relaie

Via un WebSocket persistant, ou un appel HTTP direct quand le pair est joignable publiquement.

3

Thea exécute la boucle

Avec son modèle, son prompt, ses outils.

4

Les outils s'exécutent là où ils vivent

Un outil qui n'existe que sur Hermes est rappelé sur Hermes. Le résultat revient dans la boucle de Thea.

5

Le tour arrive des deux côtés

La conversation terminée se synchronise vers votre miroir.

Pas de clé API ? Le tour se termine quand même.

L'instance qui exécute un tour a besoin de la clé API du fournisseur du modèle. Toutes les instances n'en ont pas.

Avant de prendre en charge un tour, une instance vérifie la présence de la clé du fournisseur sur son propre nœud. Absente ? Elle échoue tout de suite avec un marqueur clair : elle ne reste pas bloquée et n'écrit pas le fil à moitié.

Le côté appelant reconnaît le marqueur, annule sa comptabilité de relais et exécute la boucle lui-même. Le prompt et les outils de l'instance distante s'appliquent toujours ; les appels d'outils font l'aller-retour via la connexion.

Qui exécute la boucle ?

L'instance distante a la cléL'instance distante exécute le tour. Les outils font l'aller-retour.
L'instance distante n'a pas de cléL'instance distante échoue tout de suite. L'appelant exécute le tour avec le prompt et les outils de l'instance distante.
Mode fournisseur d'inférenceL'instance fournisseur exécute le modèle. L'appelant n'a besoin d'aucune clé.
Le mode fournisseur d'inférence n'a besoin d'aucune clé. Utilisez l'instance connectée comme fournisseur de modèles et votre côté ne touche jamais à une clé de fournisseur. La connexion sert de tuyau vers le modèle.

Sous le capot

Pour ceux qui lisent le diff.

Le transport est négocié à la connexion, jamais configuré à la main. La cible envoie au demandeur un health check authentifié (5 secondes max). Joignable : HTTP direct. Derrière un NAT : le côté masqué ouvre un seul WebSocket sortant et tous les relais sont multiplexés dessus.

Le connecteur se reconnecte avec un backoff exponentiel de 1 à 30 secondes et relit la connexion à chaque nouvelle tentative. Cette version renforce ce chemin.

Le marqueur que renvoie un destinataire sans clé :

relay/receiver.ts
// relay/constants.ts
export const RELAY_RECEIVER_NO_PROVIDER_KEY =
  "[relay-receiver-no-provider-key]";

// receiver: no provider key on this node? fail fast, let the caller run it
if (ctx.mode === "relay" && data.model) {
  const missingKey = getMissingProviderKeyMessage(getChatModelById(data.model));
  if (missingKey !== null) {
    return fail({ /* ...marker + reason... */ });
  }
}

Aussi dans cette version

  • Avertissement de lead obsolète : une trame adressée à un lead que cette instance ne connaît plus est rejetée avec un avertissement au lieu d'être ignorée en silence. Réauthentifier la connexion règle le problème.
  • Horodatages de la base en UTC, pour Postgres en pool comme pour PGlite : les lignes horodatées par défaut se trient correctement d'une instance à l'autre.
  • Le stream writer initialise l'id du fil : les pairs ne rejettent plus d'événements avec un id de fil vide.
  • Les tours de reprise se synchronisent avec le pair : les résultats d'outils complétés sur place arrivent jusqu'au miroir.

Essayez

Auto-hébergez une instance, puis ajoutez la connexion dans Admin → Remote Connections. Seuls les admins peuvent en créer une ; l'autre côté reçoit automatiquement son entrée.

Faites tourner votre propre Hermes.

Auto-hébergez next-vibe sur votre machine, connectez-le à un serveur, et laissez-les se partager le travail.

Retour au blog