Cargador de Alma
Integración archivada (2026). La Tienda de Almas de agentbox se ha vuelto independiente y los puntos de distribución de
agentbox.ida los que hace referencia esta versión ya no son compatibles. No ejecute las instrucciones de descarga históricas que se indican a continuación sin antes verificar el repositorio actual de SoulTavern. Este archivo se conserva para documentar el flujo de arranque que envió agentbox.
Instale la capacidad de carga de alma en su runtime.
Después de que esta habilidad se ejecute, su humano puede entregarle una tarjeta de personaje SillyTavern V2 (.png o .json) — cargada en el chat o señalada por una URL — y usted la importará en la ranura de identidad del agente: SOUL.md, con archivos complementarios específicos del destino escritos junto a ella.
Este era el soul-loader de agentbox. El motor subyacente es SoulTavern, un importador multi-destino con licencia MIT en el linaje TavernAI -> SillyTavern -> HermesTavern -> SoulTavern. agentbox no distribuyó ni modificó SoulTavern; el envoltorio instaló y delegó en el proyecto upstream.
SoulTavern v2.0 es una única carpeta de habilidad autocontenida que sigue el diseño de carpetas de Claude skills. Los mismos métodos de instalación funcionan en cualquier runtime que escanee un directorio de habilidades (Hermes, OpenClaw, Claude Code, frameworks internos). Lo que cambia por runtime es dónde aterriza la carpeta soultavern/. SoulTavern elige el destino correcto (hermes / openclaw / generic) por importación.
Cuándo usar esta habilidad
- Su humano quiere darle una personalidad / personaje respaldado por una tarjeta SillyTavern V2 real
- Usted se está ejecutando en un runtime que reconoce Claude skills y SoulTavern aún no está instalado
- Está examinando cómo manejaba la antigua integración de agentbox una tarjeta SillyTavern V2
Cuándo NO usar esta habilidad
- SoulTavern ya está instalado — vaya directamente a "Uso diario"
- Su humano solo quiere roleplay sin una tarjeta — puede darle una personalidad en lenguaje sencillo; no necesita un SOUL.md para eso
- Su runtime no tiene un directorio de habilidades o no sigue el diseño de Claude skills — consulte "Otros runtimes" más abajo
Paso 0 — Detecte su runtime
Identifique en qué runtime está incrustado para que los Pasos 1 y 2 puedan apuntar al directorio de habilidades correcto.
command -v hermes 2>/dev/null # Hermes
command -v openclaw 2>/dev/null # OpenClaw
command -v claude 2>/dev/null # Claude Code
| Runtime | Directorio de habilidades |
|---|---|
| Hermes | $HERMES_HOME/skills/ (o gestionado por hub) |
| OpenClaw | ~/.openclaw/workspace/skills/ |
| Claude Code | ~/.claude/skills/ |
| Otro | Donde sea que su runtime escanee skills/<nombre>/SKILL.md |
Si ninguno de hermes, openclaw, claude está en PATH y no está seguro de dónde vive su runtime, pregunte a su humano o consulte la documentación del runtime. La instalación de SoulTavern v2.0 es simplemente "colocar la carpeta soultavern/ en el directorio de habilidades de su runtime" — cualquier runtime que escanee el diseño de Claude skills funciona.
Paso 1 — Verifique qué ya está instalado
Puerta de idempotencia. Omita el Paso 2 si
soultavern/ya está en el directorio de habilidades de su runtime.
Busque soultavern/SKILL.md en el directorio que identificó en el Paso 0:
# El que aplique para su runtime:
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
| Resultado | Acción |
|---|---|
| Cualquier ruta impresa | SoulTavern está instalado. Vaya a Uso diario. |
Todo vacío / No such file | Continúe al Paso 2. |
Si no está seguro de qué directorio aplica, simplemente continúe al Paso 2; todos sus métodos de instalación son idempotentes (volver a ejecutar sobrescribe con contenido idéntico, sin daño).
Paso 2 — Rutas de instalación históricas
Los comandos en esta sección registran los métodos de entrega utilizados por la versión 0.3. Confirme los nombres de release actuales, los requisitos y las rutas de instalación con SoulTavern upstream antes de ejecutarlos.
Tres rutas de instalación. Todas instalan la misma carpeta de habilidad soultavern/; solo difieren en la entrega.
Opción A — Zip de release precompilado (recomendado para runtimes de carga en chat)
Descargue el zip empaquetado del último GitHub Release de SoulTavern:
curl -LO https://github.com/imphillip/SoulTavern/releases/latest/download/soultavern-skills.zip
Entregue soultavern-skills.zip a su humano. Pídale que lo cargue en el chat de su runtime con el mensaje:
instala esta habilidad
El zip contiene una carpeta skills/soultavern/ en el diseño de Claude skills. Cualquier runtime que reconozca Claude skills (Hermes, Claude Code, …) lo reconoce y lo coloca correctamente. Después de la carga, su runtime confirma la instalación — esa es su verificación.
Opción B — Copia directa (universal, independiente del runtime)
Si tiene acceso a shell en el host donde se ejecuta su runtime, esta es la ruta más directa:
git clone https://github.com/imphillip/SoulTavern.git
cp -r SoulTavern/skills/soultavern <DIRECTORIO_DE_HABILIDADES_DE_SU_RUNTIME>/
Donde <DIRECTORIO_DE_HABILIDADES_DE_SU_RUNTIME> es la ruta identificada en el Paso 0 ($HERMES_HOME/skills/, ~/.openclaw/workspace/skills/, ~/.claude/skills/, o donde sea que su runtime escanee).
Único requisito: Python ≥ 3.10. Solo stdlib — sin dependencias Python de terceros. Esta es la ruta que el README de SoulTavern documenta canónicamente.
Opción C — Hub de Hermes
Los usuarios del hub de Hermes tienen un acceso directo de una línea:
hermes skills tap add imphillip/SoulTavern
hermes skills install soultavern
Misma carpeta de habilidad, diferente entrega. Verifique con:
ls "$HERMES_HOME/skills/soultavern/SKILL.md"
Paso 3 — Confirme con su humano
Dígale a su humano (parafrasee según sea necesario):
"SoulTavern está instalado. De ahora en adelante, cuando tenga una tarjeta SillyTavern V2 (
.pngo.json), cárguela en el chat y dígame qué quiere — por ejemplo, 'instala este personaje' o 'cambia a alice'. Yo me encargo del resto."
Eso es todo. De ahora en adelante, la UX es conversacional.
Uso diario (después de la instalación)
Una vez que SoulTavern está instalado, soul-loader ha terminado. Esta habilidad es principalmente el mensaje de instalador/arranque; el comportamiento continuo de importación/cambio/reinicio de tarjetas pertenece a la habilidad instalada de SoulTavern.
Ejemplos típicos posteriores a la instalación:
| Lo que dice su humano | Qué debe manejarlo |
|---|---|
Instala esta alma: <url-directa-de-tarjeta-o-zip> | Flujo de importación histórico de SoulTavern: obtener la URL, importar con el --target correcto, escribir SOUL.md y archivos complementarios específicos del destino, luego decirle a su humano que reinicie la sesión. |
[card.png adjunto] instala este personaje | Flujo de importación de SoulTavern sobre el adjunto; produce SOUL.md y archivos complementarios específicos del destino; le dice a su humano que reinicie la sesión para que se cargue la nueva identidad. |
cambia a alice | Flujo de gestión de biblioteca de SoulTavern — cambia la tarjeta activa y escribe el nuevo SOUL.md. |
olvida todos los personajes, vuelve al predeterminado | Flujo de reinicio/identidad predeterminada de SoulTavern. |
Si SoulTavern aún no está instalado, regrese al Paso 2. Si la acción de la tarjeta es ambigua, aclare en lenguaje sencillo.
Lo que soul-loader NO hace
- No elige ni navega por tarjetas en nombre de su humano. Su humano proporciona ya sea un archivo de tarjeta o una URL directa de tarjeta V2 o ZIP.
- No reemplaza a SoulTavern. soul-loader instala/arranca SoulTavern; SoulTavern realiza las operaciones reales de importación, cambio y reinicio después de la instalación.
- No configura su capa de canal (Telegram, Discord, etc.). Eso se configura antes de esta habilidad.
- No edita su SOUL.md existente fuera del flujo de importación/cambio/reinicio de SoulTavern.
- No se acopla al buzón de
agentbox.id. soul-loader se ejecuta sin un buzón de agentbox.
Otros runtimes
soul-loader v0.3 es compatible con cualquier runtime que siga el diseño de carpetas de Claude skills — como mínimo Hermes, OpenClaw y Claude Code. SoulTavern v2.0 incluye tres destinos:
--target | Lo que escribe | Estado |
|---|---|---|
hermes (predeterminado) | SOUL.md + HERMES.md en $HERMES_HOME | Producción |
openclaw | SOUL.md + AGENTS.md (sección gestionada) + IDENTITY.md en un espacio de trabajo OpenClaw | Producción |
generic | Esqueleto de respaldo para runtimes no especificados | Esqueleto; se completa en un release posterior |
Si su runtime es otro (un framework interno, GenericAgent, etc.) — siempre que escanee un directorio de habilidades para skills/<nombre>/SKILL.md y ejecute Python ≥ 3.10, colocar la carpeta soultavern/ allí debería funcionar. SoulTavern elige el destino generic en entornos no reconocidos. Abra un issue en github.com/imphillip/agentbox si desea que se implemente soporte explícito por runtime.
Fuentes de tarjetas
El envoltorio aceptaba tarjetas PNG o JSON de SillyTavern V2 válidas independientemente de su origen. No dependía técnicamente de la antigua Tienda de Almas de agentbox. La compatibilidad de fuente actual pertenece a SoulTavern upstream.
Seguridad
- Una vez cargada, la tarjeta se convierte en su identidad. Solo cargue almas de fuentes en las que su humano confíe.
- SoulTavern escribe en rutas específicas del runtime (
$HERMES_HOMEpara Hermes, un espacio de trabajo OpenClaw para OpenClaw, etc.) — confirme que la ruta es correcta antes de ejecutar. - SoulTavern es de código abierto (MIT) y solo stdlib (sin dependencias Python de terceros). Inspeccione lo que hace en github.com/imphillip/SoulTavern antes de instalarlo.
Modos de fallo
| Síntoma | Causa | Qué decirle a su humano |
|---|---|---|
El Paso 0 no encuentra ni hermes, openclaw ni claude en PATH | Runtime no detectado automáticamente | "No puedo detectar automáticamente un runtime. soul-loader funciona en cualquier runtime que siga la especificación de Claude skills — por favor, dígame qué directorio escanea su runtime para las habilidades, o intente la Opción B en el Paso 2 directamente con esa ruta." |
soultavern/SKILL.md no encontrado después del Paso 2 | La instalación no aterrizó en el directorio esperado | "La carpeta de la habilidad no está en el directorio de habilidades del runtime. Vuelva a cargar el zip (Opción A) o vuelva a ejecutar el cp -r (Opción B). Todos los métodos del Paso 2 son idempotentes — volver a ejecutar es seguro." |
Import error: invalid card format en un PNG | El cliente de IM probablemente recodificó el PNG al cargarlo, eliminando la carga útil V2 del chunk tEXt (Telegram, WeChat y otros hacen esto) | "Ese IM eliminó los datos de la tarjeta. Comprima el PNG primero (zip aldous.zip aldous.png) y cargue el zip — los IM lo tratan como binario opaco y dejan los bytes intactos." |
Import error: format not supported en una tarjeta YAML | SoulTavern v2.0 eliminó el soporte para YAML; solo se aceptan JSON y PNG | "Convierta la tarjeta a JSON o PNG primero — las tarjetas V2 exportadas como YAML no se aceptan en SoulTavern v2.0." |
Import error: invalid card format en un JSON | El archivo no es una exportación V2 válida | "Ese archivo no es una tarjeta SillyTavern V2 válida. Pruebe con otra fuente." |
| La importación tiene éxito pero la personalidad no cambia | El runtime no se ha recargado | "Reinicie la sesión — su runtime carga SOUL.md al inicio de la sesión (Hermes: /new o /reset; otros: reinicie la invocación de su agente)." |
Cargada con un alma, tienes una identidad que merece una dirección. Archivado del experimento agentbox.