Tutorial 14: Profiles — Multiple Agents, One Machine

Tutorial 14: Perfiles — Múltiples Agentes, Una Misma Máquina

Así que has estado disfrutando de Hermes Agent, pero ahora estás pensando: “¿Y si pudiera ejecutar un asistente de código y un bot de investigación en la misma máquina, sin que se pisen los talones?” Eso es exactamente para lo que sirven los perfiles.

¿Qué Son los Perfiles?

Piensa en un perfil como un hogar separado para cada agente de Hermes. Cada perfil tiene su propio directorio que contiene su propio config.yaml, .env, SOUL.md, memorias, sesiones, habilidades, trabajos cron y base de datos de estado. Esto significa que puedes ejecutar un asistente de código, un bot personal y un agente de investigación lado a lado — cada uno con sus propias claves de API, personalidad y memoria — sin que ninguno mezcle las cosas.

Advertencia importante: Nunca apuntes dos procesos de agente al mismo perfil. Ambos escriben memoria automáticamente, y cada uno carga las escrituras del otro en su prompt de sistema al inicio de la sesión. Dos escritores en un mismo hogar compondrán el estado del otro hasta que deje de ser algo que tú configuraste. Los perfiles existen precisamente para evitar esto. Si los agentes necesitan memoria compartida, usa un proveedor de memoria externo.

Inicio Rápido

Empezar es increíblemente simple:

hermes profile create coder       # crea el perfil + el alias de comando "coder"
coder setup                       # configura claves de API y modelo
coder chat                        # empieza a chatear

¡Eso es todo! En el momento en que creas un perfil, se convierte en su propio comando. Crea uno llamado coder e inmediatamente tendrás coder chat, coder setup, coder gateway start, y así sucesivamente.

Crear un Perfil

Tienes varias opciones al crear un perfil:

Perfil en blanco — empieza desde cero con habilidades integradas sembradas:

hermes profile create mybot

Luego ejecuta mybot setup para configurar claves de API, modelo y tokens de gateway.

Clonar solo configuración — copia el config.yaml, .env, SOUL.md y habilidades de tu perfil actual:

hermes profile create work --clone

Mismas claves de API y capacidades, pero sesiones y memoria frescas. Edita ~/.hermes/profiles/work/.env para diferentes claves de API, o ~/.hermes/profiles/work/SOUL.md para una personalidad diferente.

Clonar todo — una instantánea de trabajo completa:

hermes profile create backup --clone-all

Esto copia configuración, claves de API, personalidad, todas las memorias, habilidades, trabajos cron y plugins. El historial específico del perfil se excluye (historial de sesiones, bases de datos de estado, copias de seguridad) ya que pueden alcanzar decenas de gigabytes. Para una copia de seguridad completa que incluya historial, usa hermes profile export o hermes backup.

Clonar desde un perfil específico:

hermes profile create work --clone-from coder

Combínalo con --clone-all para una copia completa de ese perfil de origen.

Consejo profesional: Si planeas usar un perfil como trabajador kanban, pasa --description "<rol>" al crearlo para que el orquestador sepa para qué es bueno:

hermes profile create researcher --description "Lee código fuente y documentación externa, escribe hallazgos."

Uso Diario de los Perfiles

Alias de comando — cada perfil obtiene automáticamente un alias de comando:

coder chat                    # chatea con el agente coder
coder setup                   # configura los ajustes de coder
coder gateway start           # inicia el gateway de coder
coder doctor                  # verifica la salud de coder
coder skills list             # lista las habilidades de coder
coder config set model.default anthropic/claude-sonnet-4

La bandera -p — también puedes apuntar a un perfil explícitamente con cualquier comando:

hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "hola"    # funciona en cualquier posición

Predeterminado fijo — establece un predeterminado para que los comandos simples de hermes apunten a ese perfil:

hermes profile use coder
hermes chat                   # ahora apunta a coder
hermes profile use default    # vuelve al predeterminado

Es como kubectl config use-context — simple y efectivo.

Saber dónde estás — la CLI siempre muestra qué perfil está activo:

Prompt: coder ❯ en lugar de ❯
Banner: Muestra Perfil: coder al inicio
hermes profile: Muestra el nombre del perfil actual, ruta, modelo y estado del gateway

Perfiles vs Espacios de Trabajo vs Sandboxes

A menudo se confunden, pero son cosas diferentes:

Un perfil le da a Hermes su propio directorio de estado: configuración, memoria, sesiones, registros, trabajos cron y estado del gateway.
Un espacio de trabajo o directorio de trabajo es donde comienzan los comandos de terminal — controlado por separado con terminal.cwd.
Un sandbox limita el acceso al sistema de archivos. Los perfiles no ponen al agente en un sandbox.

En el backend de terminal local predeterminado, el agente aún tiene el mismo acceso al sistema de archivos que tu cuenta de usuario. Un perfil no le impide acceder a carpetas fuera del directorio del perfil.

Conclusión

Los perfiles son la forma más limpia de ejecutar múltiples agentes de Hermes independientes en una sola máquina. Cada uno tiene su propia identidad, memoria y configuración — y nunca tienen que saber que el otro existe. ¡Pruébalo con hermes profile create y mira cuánto más fluido se vuelve tu flujo de trabajo multi-agente!