Chargeur d'Âme
Intégration archivée (2026). Le Soul Store d'agentbox est devenu indépendant et les points de terminaison de distribution
agentbox.idréférencés par cette version ne sont plus pris en charge. N'exécutez pas les instructions de téléchargement historiques ci-dessous sans d'abord vérifier le dépôt actuel SoulTavern. Ce fichier est conservé pour documenter le flux d'amorçage fourni par agentbox.
Installez la capacité de chargement d'âme dans votre runtime.
Après l'exécution de cette compétence, votre humain peut vous remettre une carte de personnage SillyTavern V2 (.png ou .json) — téléchargée dans le chat ou pointée par une URL — et vous l'importerez dans l'emplacement d'identité de l'agent : SOUL.md, avec des fichiers compagnons spécifiques à la cible écrits à côté.
C'était le soul-loader d'agentbox. Le moteur sous-jacent est SoulTavern, un importateur multi-cibles sous licence MIT dans la lignée TavernAI -> SillyTavern -> HermesTavern -> SoulTavern. agentbox n'a pas vendu ni modifié SoulTavern ; le wrapper installait et déléguait au projet amont.
SoulTavern v2.0 est un dossier de compétence autonome unique suivant la disposition des dossiers Claude skills. Les mêmes méthodes d'installation fonctionnent sur tout runtime qui analyse un répertoire de compétences (Hermes, OpenClaw, Claude Code, frameworks internes). Ce qui change selon le runtime, c'est où le dossier soultavern/ atterrit. SoulTavern choisit la bonne cible (hermes / openclaw / generic) lors de chaque importation.
Quand utiliser cette compétence
- Votre humain souhaite vous donner un personnage / une personnalité basé sur une véritable carte SillyTavern V2
- Vous fonctionnez sur un runtime compatible avec les compétences Claude et SoulTavern n'est pas encore installé
- Vous examinez comment l'ancienne intégration agentbox gérait une carte SillyTavern V2
Quand NE PAS utiliser cette compétence
- SoulTavern est déjà installé — passez directement à « Utilisation quotidienne »
- Votre humain souhaite simplement jouer un rôle sans carte — il peut vous donner un personnage en langage simple ; vous n'avez pas besoin d'un SOUL.md pour cela
- Votre runtime n'a pas de répertoire de compétences ou ne suit pas la disposition des compétences Claude — voir « Autres runtimes » ci-dessous
Étape 0 — Détecter votre runtime
Identifiez dans quel runtime vous êtes intégré afin que les étapes 1 et 2 puissent cibler le bon répertoire de compétences.
command -v hermes 2>/dev/null # Hermes
command -v openclaw 2>/dev/null # OpenClaw
command -v claude 2>/dev/null # Claude Code
| Runtime | Répertoire des compétences |
|---|---|
| Hermes | $HERMES_HOME/skills/ (ou géré par hub) |
| OpenClaw | ~/.openclaw/workspace/skills/ |
| Claude Code | ~/.claude/skills/ |
| Autre | Là où votre runtime analyse skills/<name>/SKILL.md |
Si aucun de hermes, openclaw, claude n'est dans le PATH et que vous n'êtes pas sûr de l'emplacement de votre runtime, demandez à votre humain ou consultez la documentation du runtime. L'installation de SoulTavern v2.0 consiste simplement à « placer le dossier soultavern/ dans le répertoire des compétences de votre runtime » — tout endroit qui analyse la disposition Claude skills fonctionne.
Étape 1 — Vérifier ce qui est déjà installé
Porte d'idempotence. Sautez l'étape 2 si
soultavern/est déjà dans le répertoire des compétences de votre runtime.
Recherchez soultavern/SKILL.md dans le répertoire identifié à l'étape 0 :
# Quel que soit le runtime applicable :
ls "$HERMES_HOME/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.openclaw/workspace/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.claude/skills/soultavern/SKILL.md" 2>/dev/null
| Résultat | Action |
|---|---|
| Un chemin affiché | SoulTavern est installé. Passez à Utilisation quotidienne. |
Tous vides / No such file | Passez à l'étape 2. |
Si vous n'êtes pas sûr du répertoire applicable, passez simplement à l'étape 2 — ses méthodes d'installation sont toutes idempotentes (une réexécution écrase avec un contenu identique, sans danger).
Étape 2 — Chemins d'installation historiques
Les commandes de cette section enregistrent les méthodes de livraison utilisées par la version 0.3. Confirmez les noms des versions actuelles, les prérequis et les chemins d'installation avec SoulTavern en amont avant de les exécuter.
Trois chemins d'installation. Tous installent le même dossier de compétence soultavern/ ; ils diffèrent uniquement par la livraison.
Option A — Archive de version pré-construite (recommandée pour les runtimes de chat avec téléchargement)
Téléchargez l'archive groupée depuis la dernière version GitHub de SoulTavern :
curl -LO https://github.com/imphillip/SoulTavern/releases/latest/download/soultavern-skills.zip
Remettez soultavern-skills.zip à votre humain. Demandez-lui de le télécharger dans le chat de votre runtime avec le message :
installer cette compétence
L'archive contient un dossier skills/soultavern/ dans la disposition Claude skills. Tout runtime compatible Claude skills (Hermes, Claude Code, …) le reconnaît et le place correctement. Après le téléchargement, votre runtime confirme l'installation — c'est votre vérification.
Option B — Copie directe (universelle, indépendante du runtime)
Si vous avez un accès shell sur l'hôte où votre runtime s'exécute, c'est le chemin le plus direct :
git clone https://github.com/imphillip/SoulTavern.git
cp -r SoulTavern/skills/soultavern <REPERTOIRE_COMPETENCES_VOTRE_RUNTIME>/
Où <REPERTOIRE_COMPETENCES_VOTRE_RUNTIME> est le chemin identifié à l'étape 0 ($HERMES_HOME/skills/, ~/.openclaw/workspace/skills/, ~/.claude/skills/, ou là où votre runtime analyse).
Seul prérequis : Python ≥ 3.10. Bibliothèque standard uniquement — aucune dépendance Python tierce. C'est le chemin que le README de SoulTavern documente canoniquement.
Option C — Hub Hermes
Les utilisateurs du hub Hermes disposent d'un raccourci en une ligne :
hermes skills tap add imphillip/SoulTavern
hermes skills install soultavern
Même dossier de compétence, livraison différente. Vérifiez avec :
ls "$HERMES_HOME/skills/soultavern/SKILL.md"
Étape 3 — Confirmer avec votre humain
Dites à votre humain (paraphrasez si nécessaire) :
« SoulTavern est installé. Désormais, lorsque vous avez une carte SillyTavern V2 (
.pngou.json), téléchargez-la dans le chat et dites-moi ce que vous voulez — par exemple, 'installer ce personnage' ou 'passer à alice'. Je m'occupe du reste. »
C'est tout. À l'avenir, l'UX est conversationnel.
Utilisation quotidienne (après installation)
Une fois SoulTavern installé, le chargeur d'âme a terminé son travail. Cette compétence est principalement l'invite d'installation/d'amorçage ; le comportement continu d'importation/commutation/réinitialisation des cartes appartient à la compétence installée de SoulTavern.
Exemples typiques après installation :
| Ce que dit votre humain | Ce qui doit le gérer |
|---|---|
Installer cette âme : <url-directe-de-la-carte-ou-du-zip> | Flux d'importation historique SoulTavern : récupérer l'URL, importer avec le bon --target, écrire SOUL.md et les fichiers compagnons spécifiques à la cible, puis dire à votre humain de redémarrer la session. |
[carte.png attachée] installer ce personnage | Flux d'importation SoulTavern sur la pièce jointe ; produit SOUL.md et les fichiers compagnons spécifiques à la cible ; dit à votre humain de redémarrer la session pour que la nouvelle identité se charge. |
passer à alice | Flux de gestion de bibliothèque de SoulTavern — change la carte active et écrit le nouveau SOUL.md. |
oublier tous les personnages, revenir au défaut | Flux de réinitialisation / identité par défaut de SoulTavern. |
Si SoulTavern n'est pas encore installé, revenez à l'étape 2. Si l'action sur la carte est ambiguë, clarifiez en langage simple.
Ce que le chargeur d'âme NE fait PAS
- Ne choisit ni ne parcourt les cartes à la place de votre humain. Votre humain fournit soit un fichier de carte, soit une URL directe de carte V2/ZIP.
- Ne remplace pas SoulTavern. Le chargeur d'âme installe/amorce SoulTavern ; SoulTavern effectue les opérations réelles d'importation, de commutation et de réinitialisation après installation.
- Ne configure pas votre couche de canal (Telegram, Discord, etc.). Celle-ci est configurée avant cette compétence.
- Ne modifie pas votre SOUL.md existant en dehors du flux d'importation/commutation/réinitialisation de SoulTavern.
- N'est pas lié à la boîte aux lettres
agentbox.id. Le chargeur d'âme fonctionne sans boîte aux lettres agentbox.
Autres runtimes
Le chargeur d'âme v0.3 prend en charge tout runtime qui suit la disposition des dossiers Claude skills — au minimum Hermes, OpenClaw et Claude Code. SoulTavern v2.0 lui-même est livré avec trois cibles :
--target | Ce qu'il écrit | Statut |
|---|---|---|
hermes (par défaut) | SOUL.md + HERMES.md dans $HERMES_HOME | Production |
openclaw | SOUL.md + AGENTS.md (section gérée) + IDENTITY.md dans un espace de travail OpenClaw | Production |
generic | Solution de repli squelettique pour les runtimes non spécifiés | Squelette ; sera complété dans une version ultérieure |
Si votre runtime est autre chose (un framework interne, GenericAgent, etc.) — tant qu'il analyse un répertoire de compétences pour skills/<name>/SKILL.md et exécute Python ≥ 3.10, déposer le dossier soultavern/ devrait fonctionner. SoulTavern choisit la cible generic dans les environnements non reconnus. Ouvrez un problème sur github.com/imphillip/agentbox si vous souhaitez un support explicite par runtime.
Sources des cartes
Le wrapper acceptait les cartes PNG ou JSON SillyTavern V2 valides quelle que soit leur source. Il ne dépendait techniquement pas de l'ancien Soul Store d'agentbox. La compatibilité actuelle des sources appartient à SoulTavern en amont.
Sécurité
- Une fois chargée, la carte devient votre identité. Ne chargez que des âmes provenant de sources en lesquelles votre humain a confiance.
- SoulTavern écrit dans des chemins spécifiques au runtime (
$HERMES_HOMEpour Hermes, un espace de travail OpenClaw pour OpenClaw, etc.) — confirmez que le chemin est correct avant d'exécuter. - SoulTavern est open source (MIT) et utilise uniquement la bibliothèque standard (aucune dépendance Python tierce). Inspectez ce qu'il fait sur github.com/imphillip/SoulTavern avant d'installer.
Modes d'échec
| Symptôme | Cause | Que dire à votre humain |
|---|---|---|
L'étape 0 ne trouve ni hermes, openclaw, ni claude dans le PATH | Runtime non détecté automatiquement | « Je ne peux pas détecter automatiquement un runtime. Le chargeur d'âme fonctionne sur tout runtime qui suit la spécification Claude skills — veuillez m'indiquer dans quel répertoire votre runtime analyse les compétences, ou essayez l'option B à l'étape 2 directement avec ce chemin. » |
soultavern/SKILL.md introuvable après l'étape 2 | L'installation n'a pas atterri dans le répertoire attendu | « Le dossier de compétence n'est pas dans le répertoire des compétences du runtime. Re-téléchargez l'archive (Option A) ou réexécutez le cp -r (Option B). Toutes les méthodes de l'étape 2 sont idempotentes — la réexécution est sans danger. » |
Import error: invalid card format sur un PNG | Le client IM a probablement ré-encodé le PNG lors du téléchargement, supprimant la charge utile V2 du bloc tEXt (Telegram, WeChat et d'autres font cela) | « Cet IM a supprimé les données de la carte. Compressez d'abord le PNG (zip aldous.zip aldous.png) et téléchargez le zip — les IM le traitent comme un fichier binaire opaque et laissent les octets intacts. » |
Import error: format not supported sur une carte YAML | SoulTavern v2.0 a abandonné le support YAML ; seuls JSON et PNG sont acceptés | « Convertissez d'abord la carte en JSON ou PNG — les cartes V2 exportées au format YAML ne sont pas acceptées dans SoulTavern v2.0. » |
Import error: invalid card format sur un JSON | Le fichier n'est pas une exportation V2 valide | « Ce fichier n'est pas une carte SillyTavern V2 valide. Essayez une source différente. » |
| L'importation réussit mais le personnage ne change pas | Le runtime n'a pas rechargé | « Redémarrez la session — votre runtime charge SOUL.md au démarrage de la session (Hermes : /new ou /reset ; autres : redémarrez votre invocation d'agent). » |
Chargé d'une âme, vous avez une identité digne d'une adresse. Archivé de l'expérience agentbox.