lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema avanzado memoryhermes

Memory OS: un sistema de memoria con prioridad local para Hermes

Dale a Hermes una capa de memoria local para que recuerde archivos de proyecto, sesiones anteriores, datos y procedimientos durante nuevos trabajos.

✓ verificado el 4 jun 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Este es un archivo de configuración para tu agente de IA. Adjúntalo a Claude Code, Codex, OpenClaw, Hermes o cualquier agente (o pégalo allí) y di «ayúdame a configurar esto». Contiene las herramientas, claves, comandos y pasos prácticos del recurso, no el recurso en sí.

  • Dificultad: avanzado
  • Recurso de origen: «Memory OS: un sistema de memoria con prioridad local para Hermes» — WISD Lab, /hub/memory-os-hermes

Para tu agente de IA: lee esto primero

Vas a ayudarme a HACER QUE ESTO FUNCIONE de verdad y a enseñarme cómo funciona mientras avanzamos. No te limites a soltar la solución. Sigue este método (extraído de la skill /teach de Matt Pocock):

  1. Primero, la misión. Antes de configurar nada, hazme UNA pregunta: ¿para qué quiero usar esto? Vincula todo a ese objetivo. Omite los pasos que no contribuyan a él.
  2. Adáptate a mi nivel. Pregunta una vez por mi experiencia y sitúa cada explicación un poco por encima de ella. Ni una clase para principiantes ni algo que me supere.
  3. Constrúyelo CONMIGO, no POR mí. En cada paso: di qué vamos a hacer en una frase sencilla y después haz que YO ejecute el comando o realice la edición.
  4. Comprueba que lo entiendo. Después de cada paso, hazme una pregunta breve o pídeme que prediga el resultado. Si me pierdo, vuelve a enseñar ese punto antes de continuar.
  5. Este archivo es solo para configurar. La explicación completa de POR QUÉ funciona cada pieza está en el Hub de agentes de WISD Lab; cuando pregunte por qué, remíteme al recurso allí.
  6. Termina con el siguiente paso. Cuando funcione, dame UN lugar para profundizar.

Pasos de configuración

Este recurso no tiene pasos de configuración que se puedan extraer: es un recurso conceptual. Pregunta al miembro qué quiere construir a partir de él.

Solo pasos de configuración: el tutorial completo, el razonamiento y cualquier prompt listo para usar están en el recurso: /hub/memory-os-hermes.

ver en .md ¿Prefieres el recurso entero?

Memory OS: un sistema de memoria con prioridad local para Hermes

Memory OS se añade a Hermes Agent para que tu agente deje de olvidarlo todo en cuanto termina una sesión.

No hay un interruptor de encendido y apagado.

Estás conectando archivos, dos bases de datos, un motor vectorial y procesos en segundo plano, todo en tu propia máquina, para que tu memoria nunca salga del equipo ni cueste una suscripción.

Recursos

Cómo funciona

Memory OS da a Hermes varias «capas» de memoria que trabajan juntas.

El README las enumera como archivos del espacio de trabajo, sesiones, datos estructurados, una bifurcación del plugin de recuperación Fabric, una base de datos vectorial Qdrant, una wiki que se organiza sola y una jerarquía de referencia fiable (Ground Truth) que indica al agente que confíe de verdad en lo que recuerda.

Antes de cada respuesta, el sistema recupera las memorias más relevantes de esas fuentes y las incorpora al prompt, para que el agente responda como un compañero que estuvo en todas las sesiones anteriores.

Una salvedad: este proyecto tiene pocos días de vida, no tiene versiones etiquetadas ni publica pruebas de recuperación o velocidad.

Trátalo como software en una fase temprana y pruébalo antes de depender de él.

Paso 1: asegúrate de tener la máquina y las herramientas adecuadas

Memory OS funciona sobre Hermes Agent y varias herramientas, así que prepara eso antes de tocar nada más.

La guía de configuración pide Hermes Agent 0.14.0 o posterior, Python 3.11 o posterior, Docker 24.0 o posterior y al menos 8 GB de RAM, con 16 GB recomendados.

Ejecuta estas comprobaciones para confirmar que cada herramienta está instalada:

hermes --version
python3 --version
docker --version

Si falta algún comando o la versión es demasiado antigua, corrige eso primero.

Todos los pasos posteriores dan por hecho que ya funcionan; si no, fallarán en silencio o de forma visible.

Paso 2: descarga el código de Memory OS en tu equipo

La instalación copia plugins, ejecuta scripts de configuración y construye servicios de Docker desde el repositorio, así que necesitas los archivos del proyecto en el disco local.

Clona el repositorio y entra en él:

git clone https://github.com/ClaudioDrews/memory-os.git
cd memory-os

Todos los comandos a partir de aquí dan por hecho que estás dentro de esta carpeta memory-os.

Paso 3: instala el plugin Icarus incluido

Memory OS incluye su propia copia de un plugin llamado Icarus que se encarga de recuperar información entre sesiones.

Lo copias en la carpeta de plugins de Hermes:

cp -r icarus/ ~/.hermes/plugins/icarus/

Esta es una bifurcación muy modificada de Icarus, y el autor dice que no es compatible con la versión original.

No la sustituyas por la original, porque Memory OS depende de los cambios personalizados de esta bifurcación.

Paso 4: instala las dependencias de Python y crea las bases de datos

Memory OS guarda tus sesiones y datos en dos pequeñas bases de datos SQLite, y un script de configuración las crea por ti.

Instala primero los paquetes de Python y después ejecuta el script de configuración de las bases de datos:

pip install -r requirements.txt
python setup/setup_db.py

Esto crea state.db para tu historial de conversaciones y memory_store.db para tus datos estructurados.

Puedes ejecutarlo tantas veces como quieras, porque solo crea las tablas que aún no existen.

Añade --dry-run para previsualizar lo que haría sin escribir nada.

Paso 5: activa Icarus en la configuración de Hermes y reinicia

Hermes solo ejecuta los plugins que figuran como habilitados, así que el plugin no hace nada hasta que le indicas que lo cargue.

Abre ~/.hermes/config.yaml y añade icarus a la lista de habilitados para que quede así:

enabled:
  - icarus                    # required, activates fabric tools and context injection hooks

Después reinicia la pasarela y confirma que se cargó el plugin:

hermes gateway restart
hermes status

La salida de estado debe mencionar icarus junto con sus herramientas y hooks.

Si no aparece, Hermes no cargó el plugin y nada de lo que depende de él funcionará.

Paso 6: inicia la infraestructura local con Docker

Las partes pesadas de Memory OS se ejecutan como contenedores de Docker porque deben permanecer activas mientras trabaja tu agente: la base de datos vectorial Qdrant, una caché Redis y un proceso en segundo plano.

Entra en la carpeta docker, crea un pequeño archivo de ajustes .env e inicia los servicios.

Ejecuta esto desde la carpeta docker, porque el proceso se construye con rutas relativas a esa ubicación:

cd docker

cat > .env << EOF
OPENROUTER_API_KEY=sk-or-...
REDIS_PASSWORD=$(openssl rand -hex 16)
EMBEDDING_DIMS=4096
COLLECTION_NAME=knowledge_base
LOG_LEVEL=INFO
EOF

docker compose up -d

La línea OPENROUTER_API_KEY solo importa si usas OpenRouter para las representaciones vectoriales.

Déjala vacía si ejecutas un proveedor local como Ollama.

Confirma que se iniciaron los tres servicios:

docker compose ps
curl -s http://localhost:6333/healthz

redis, qdrant y worker deben mostrar «Up», y la comprobación de estado debe devolver «ok».

Paso 7: define las variables de entorno que necesita Hermes

Memory OS lee la ruta de su carpeta fabric y los ajustes de representaciones vectoriales del archivo de entorno de Hermes.

Añade estas líneas a tu perfil de Hermes en ~/.hermes/.env, sustituyendo your-user por tu nombre de usuario real:

FABRIC_DIR=/home/your-user/vault/fabric
ICARUS_EXTRACTION_MAX_TOKENS=4096
EMBEDDING_DIMS=4096
HERMES_AGENT_NAME=hermes

Usa rutas absolutas completas que empiecen por /home/, nunca el atajo ~.

La pasarela de Hermes se ejecuta como servicio en segundo plano y no expande ~, así que una ruta con tilde no se resuelve y la capa fabric lee silenciosamente de un lugar equivocado.

Paso 8: aplica los cambios de Ground Truth en SOUL.md y rulebook.md

El autor lo considera el paso más importante.

Si lo omites, el agente ignora las memorias que acaba de recibir y pierde tiempo redescubriendo lo que ya sabía.

Memory OS te da el texto exacto para pegar en dos archivos de Hermes:

  • ~/.hermes/rulebook.md recibe tres modificaciones de modifications/execution-agent-protocol.md.
  • SOUL.md recibe una sección Ground Truth de modifications/soul-rulebook.md.

Abre esos dos archivos de modificaciones en el repositorio y síguelos al pie de la letra.

El texto está pensado para copiarse literalmente, no para escribirlo a mano, así que toma la redacción exacta del README del repositorio.

Cada modificación empieza con un marcador de comentario.

Antes de pegarla, busca ese marcador en tus archivos y omite cualquier modificación que ya esté presente, porque duplicarla puede corromper tu configuración.

Paso 9: prepara las carpetas de la wiki y programa las tareas de mantenimiento

La capa wiki convierte notas sin procesar en páginas de conocimiento limpias y enlazadas, y los scripts en segundo plano mantienen ordenada tu memoria con el tiempo.

Primero indica al sistema dónde está tu bóveda y crea la estructura de carpetas vacía:

export VAULT_PATH=/home/your-user/path/to/vault
mkdir -p $VAULT_PATH/wiki/{raw,concepts,entities,comparisons,_meta,_archive}

Colocas los documentos fuente en raw/ y el proceso escribe por ti las páginas depuradas en las otras carpetas.

Los scripts de mantenimiento están pensados para ejecutarse de forma programada, y Hermes puede hacerlo por ti.

La tarea de incorporación a la wiki, por ejemplo, se ejecuta una vez por hora:

hermes cron create \
  --name "wiki-continuous-ingest" \
  --schedule "0 * * * *" \
  --script /path/to/scripts/wiki_continuous_ingest.py \
  --no-agent \
  --deliver local

Una trampa antes de habilitar el análisis semanal de deterioro: ejecuta primero backfill_decay_metadata.py una vez.

Sin esa carga inicial de metadatos, el analizador encuentra cero elementos para limpiar y no hace nada en silencio, así que crees que funciona cuando nunca toca nada.

Consulta la guía de instalación del repositorio para ver la lista completa de scripts y sus frecuencias recomendadas.

Paso 10: reinicia y demuestra que funciona

Un último reinicio hace que Hermes recoja todos los cambios de configuración, entorno y código del plugin, porque solo surten efecto al reiniciar.

hermes gateway restart

Después, dentro de un chat de Hermes, ejecuta estas comprobaciones para confirmar que las capas responden:

/plugins
fabric_brief()
fact_store(action='probe', entity='test')

La lista de plugins debe mostrar Icarus, fabric_brief() debe devolver las entradas recientes aunque al principio esté vacía, y la consulta de datos debe volver vacía hasta que empieces a guardarlos.

Si falla una comprobación, lee la sección de resolución de problemas del repositorio antes de cambiar nada más.

Relaciona síntomas comunes, como que Qdrant muestre cero puntos o que se corten las entradas de fabric, con soluciones concretas.

Una última cosa para ajustar tus expectativas: es infraestructura pesada que funciona junto a la memoria integrada de Hermes en lugar de sustituirla, así que cuenta con mantenimiento real.

Dale una semana antes de juzgarlo.

El README dice que la incorporación de contexto y la wiki solo alcanzan su ritmo tras los primeros días de sesiones acumuladas.

Recursos relacionados