# Instrucciones para el agente: Hermes Workflows: conecta tareas con condiciones y revisión

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/itechmeat/hermes-workflows
- Guía completa: https://lab.wisd.ai/hub/hermes-workflows-plugin

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: comprueba el host

Comprueba Python ≥3.11 en el entorno de Hermes, según el [manifiesto del plugin](https://github.com/itechmeat/hermes-workflows/blob/main/pyproject.toml). Confirma que el panel de Hermes abre en Linux, macOS o WSL y que tu versión incorpora las correcciones de sesión #48584 y #48633 enlazadas en el README. Comprueba que puedes configurar el proxy inverso del panel.

### Paso 2: instala y reinicia

```bash
hermes plugins install itechmeat/hermes-workflows --enable
hermes gateway restart
```

### Paso 3: conecta la API del panel

Para esta instalación desde un repositorio, configura el [servicio auxiliar oficial](https://github.com/itechmeat/hermes-workflows/blob/main/docs/dashboard.md#running-the-backend-standalone-sidecar). Desde la carpeta estable `~/.hermes/plugins/hermes-workflows`, su orden de arranque es:

```bash
bin/hermes-workflows-dashboard-api
```

El wrapper usa el Python del entorno de Hermes; comprueba que allí se pueden importar `fastapi` y `uvicorn`, incluidos en el runtime del panel. Si la instalación de Hermes está fuera de las ubicaciones detectadas, configura `HERMES_AGENT_HOME` con la ruta real o `HERMES_WORKFLOWS_PYTHON` con su intérprete, como documenta el [wrapper](https://github.com/itechmeat/hermes-workflows/blob/main/bin/hermes-workflows-dashboard-api). Para la primera prueba mantén esa terminal abierta y usa otra para consultar `curl http://127.0.0.1:9123/healthz`; después mantenlo como servicio con la configuración de systemd o launchd de esa guía. En el proxy del panel, dirige `/api/plugins/workflows/*` a `127.0.0.1:9123` antes de la ruta general. Conserva la autenticación del panel y comprueba que Workflows carga datos.

### Paso 4: prueba un grafo pequeño

En el panel crea una tarea sin efectos externos y una compuerta de revisión. Ejecuta una vez manualmente antes de definir un horario.

## Comprobación

Comprueba que el inspector muestra cada nodo, que el resultado pasa al siguiente y que la compuerta detiene realmente el flujo hasta tu intervención.

## Si algo falla

Si no aparece el panel o un nodo no avanza, comprueba la compatibilidad de Hermes y sus primitivas nativas. Revisa el estado de la tarjeta y el inspector antes de relanzar todo el flujo.

Consulta el [README oficial](https://github.com/itechmeat/hermes-workflows#readme) para el procedimiento completo y los cambios de versión.