# Instrucciones para el agente: Argus: un asistente que recupera recuerdos con fuentes

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/quarqlabs/argus (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/quarq-agent-oss

---

## 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: prepara el entorno

Comprueba Python ≥3.11 y Git. Ten disponible una clave de OpenAI para configurarla después de instalar; el script crea el entorno virtual e instala las dependencias. Usa la ruta macOS/Linux siguiente; Windows tiene un comando distinto en el README.

### Paso 2: sigue la instalación oficial

```bash
git clone https://github.com/quarqlabs/argus.git
cd argus
python3 scripts/setup_argus.py
```

## Comprobación

En el `.env` privado creado por el instalador configura `OPENAI_API_KEY` y conserva o define `USER_ID=local_user`, `AGENT_ID=local_agent` y `LOCAL_MEMORY_ROOT=local_memory`, como indica el README. Abre una terminal nueva y ejecuta `argus`. Escribe «Recuerda que el nombre del proyecto de ensayo es Nube Naranja». Cierra y vuelve a abrir `argus` con el mismo AGENT_ID; pregunta «¿Cómo se llama mi proyecto de ensayo?»; comprueba su atribución y los eventos de recuperación.

## Si algo falla

Si el lanzador no aparece, sigue la actualización de PATH que imprime el instalador. El README explica cómo reparar el lanzador si has movido la carpeta.

[Fuente de los comandos y del procedimiento](https://github.com/quarqlabs/argus#readme).