# Instrucciones para el agente: Hermes Talk: habla con tu agente mientras trabaja

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: intermedio
- Proyecto: https://github.com/TheSmokeDev/hermes-talk (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/hermes-talk-realtime-voice

---

## 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

Comprueba que tienes Hermes ≥v0.17 y Python ≥3.11 con pip en el mismo entorno que usa Hermes. Revisa los requisitos adicionales de tu proveedor en [OPERATING.md](https://github.com/TheSmokeDev/hermes-talk/blob/main/docs/OPERATING.md#prerequisites) antes de instalar; las rutas GPT-Live requieren más capacidades del host.

La instalación fijada en el README es:

```sh
hermes plugins install --ref 7ad833e4fcedb2c9a9947d84d7fd89bdbd15d256 TheSmokeDev/hermes-talk --enable
pip install "hermes-talk[audio]"
```

Comprueba antes la nota de compatibilidad con tu versión de Hermes. Para terminal, comprueba también PortAudio además del extra `audio`. El [manual operativo](https://github.com/TheSmokeDev/hermes-talk/blob/main/docs/OPERATING.md#prerequisites) admite `TALK_OPENAI_API_KEY`, `OPENAI_API_KEY` o una suscripción conectada con `codex login`. Elige una vía y configúrala en privado en el entorno que usa Hermes; no basta con el acceso al modelo de texto de Hermes. Después abre:

```sh
hermes talk
```

Empieza con una consulta que no ejecute acciones externas.

## Comprobación

Comprueba entrada de micrófono, respuesta por altavoz e interrupción de la conversación. Después prueba una herramienta de lectura y contrasta su resultado.

## Si algo falla

Si no hay audio, revisa dispositivos y dependencias. Si la voz funciona pero la herramienta falla, revisa la integración de Hermes y los permisos por separado.

Consulta [el README oficial](https://github.com/TheSmokeDev/hermes-talk#readme) para requisitos y variantes de instalación.