# Instrucciones para el agente: Jev Ultrafast: ejecuta tareas web con decisiones sobre los controles

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/browser-use/jev-ultrafast (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/jev-ultrafast-web-agent

---

## 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 que tienes Python 3.12 o posterior, uv y Chrome. Sigue la instalación del [README oficial](https://github.com/browser-use/jev-ultrafast/blob/1231850a0bf1a0c0341fe408ef1668dbbfdfac46/README.md#try-it). Usa datos de prueba y revisa qué perfil de Chrome conectas.

### Paso 2: descarga e instala

Estos comandos proceden del README; ejecútalos en el equipo donde vayas a usar el navegador:

```bash
git clone https://github.com/browser-use/jev-ultrafast.git
cd jev-ultrafast
uv sync
cp .env.example .env
```

Completa el archivo local con tus propias claves en TYPESAFE_API_KEY y TEXT_MODEL_API_KEY. El ejemplo usa OpenRouter para generar texto. Mantén las claves fuera del chat y del control de versiones.

### Paso 3: conecta Chrome e inicia el inspector

```bash
uv run browser-harness --doctor
uv run jev
```

El primer comando diagnostica la conexión de Browser Harness. Permite la depuración remota de Chrome cuando la herramienta lo solicite. Abre http://127.0.0.1:8766. Empieza con **Choose next** para examinar la selección antes de ejecutar; el README también ofrece **Start demo → Run automatically**.

## Comprobación

Comprueba que el inspector enumera elementos y muestra operaciones, destinos y acciones. Revisa el resultado en la página: campos, ruta y contenido visible. No tomes DONE como comprobación suficiente. Los ejemplos en vivo consumen API.

## Si algo falla

Si Chrome no conecta, revisa la salida de Browser Harness. Si falla TYPE_TEXT, comprueba la clave y los ajustes del proveedor de texto del ejemplo oficial. Si un control está en un frame, shadow root o canvas, consulta las exclusiones del MVP antes de intentar corregirlo con instrucciones al modelo.