Sistema de Perfiles y Distribuciones

Podemos usar Hermes para crearmúltiples agentes independientes—uno dedicado a escribir código, otro a operaciones, y otro para investigación.

Este capítulo presenta cómo el sistema de Perfiles ejecuta múltiples instancias de agente completamente aisladas en una sola máquina, y cómo empaquetar todo el agente como una distribución para compartir con otros.

Sistema de Perfiles: una máquina, múltiples agentes independientes

Qué es un Perfil

Un Perfil es un directorio principal independiente de Hermes. Cada Perfil tiene su propia configuración y datos completamente aislados:

~/.hermes/profiles/<name>/
├── config.yaml     # 模型、工具、终端后端等所有设置
├── .env            # API Key、Bot Token（各档案各自独立）
├── SOUL.md         # Agent 人格与身份设定
├── memories/       # 独立的持久记忆（MEMORY.md、USER.md）
├── skills/         # 独立的技能目录
├── cron/           # 独立的定时任务
└── state.db        # 独立的会话历史数据库

Diseño clave: después de crear un Perfil, automáticamente se convierte en un comando independiente. Al crear un Perfil llamado coder, inmediatamente tendráscoder chat、coder setup、coder gateway starty todos los demás subcomandos—como si hubieras instalado una instancia de Hermes completamente independiente.

Inicio rápido

Tres pasos para crear un asistente de codificación independiente:

Tres modos de creación

Cambiar y usar Perfiles

Determinar en qué Perfil estás actualmente:

• El aviso del comando muestracoder ❯(en lugar del normal❯）
• El banner de inicio muestraProfile: coder
• Ejecutarhermes profileVer el nombre, ruta, modelo y estado de la puerta de enlace del Perfil actual

Diferencia entre Perfil, directorio de trabajo y sandbox

Estos son los tres conceptos más fáciles de confundir:

Un Perfil no es un sandbox: con el backend local predeterminado, el agente aún tiene los mismos permisos de sistema de archivos que tú. Si necesitas restringir el alcance de acceso, cambia el backend de terminal (ver capítulo 05).

Hacer que un Perfil comience a trabajar fijo desde un directorio específico:

Puerta de enlace multi-Perfil: cada agente se conecta a una plataforma diferente

Cada Perfil ejecuta su propio proceso de puerta de enlace independiente, usando su propio token de Bot:

Protección de seguridad: si dos Perfiles usan accidentalmente el mismo token de Bot, la segunda puerta de enlace reportará un error inmediatamente e indicará el nombre del Perfil en conflicto, sin que ocurra un conflicto silencioso.

Comandos de gestión de Perfiles

No se puede eliminar el Perfil predeterminado (~/.hermes). Para desinstalarlo por completo, usa hermes uninstall.

Distribuciones de Perfil: compartir todo el agente con otros

Una Distribución de Perfil empaqueta un Hermes Agent completo—configuración de personalidad, habilidades, tareas programadas, conexiones MCP, configuración—en un repositorio Git.

Cualquiera puede instalar todo el agente con un solo comando, y recibir tus actualizaciones mientras conserva su propia memoria, sesiones y claves de API.

Distribución vs copia de seguridad de Perfil

Escenarios adecuados para distribuciones

• Distribuir agentes especializados al equipo (monitoreo de cumplimiento, revisión de código, asistente de investigación)
• Desplegar el mismo agente en múltiples máquinas sin copiar archivos manualmente
• Iterar continuamente el agente y permitir que los receptores obtengan la última versión con un solo comando
• Distribuir el agente como producto a la comunidad

Crear y publicar una distribución

Primer paso: añadir en un Perfil existentedistribution.yaml：

Paso 2: enviar al repositorio Git:

.env y auth.json se excluyen automáticamente: las claves de API no entran en el repositorio. El historial de memoria y sesiones tampoco se incluye.

Instalar y actualizar distribuciones

Referencia rápida de comandos