# Instrucciones para el agente: Local Deep Research: investiga con fuentes y modelos configurables

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/LearningCircuit/local-deep-research (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/local-deep-research

---

## 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: instala y abre la interfaz

Comprueba que el intérprete tiene Python ≥3.12 y <3.15 con pip y venv, Docker con acceso al motor y Ollama instalado y en ejecución en `localhost:11434`. En x86-64 la CPU necesita AVX; dimensiona la memoria para el modelo. Esta ruta adapta la [guía pip](https://github.com/LearningCircuit/local-deep-research/blob/main/docs/install-pip.md) a un entorno aislado en macOS/Linux:

```bash
python -m venv .venv
source .venv/bin/activate
```

Instala la aplicación y prepara búsqueda y modelo:

```bash
pip install local-deep-research
docker pull searxng/searxng
docker run -d -p 8080:8080 --name searxng searxng/searxng
ollama pull gemma3:12b
export LDR_SEARCH_ENGINE_WEB_SEARXNG_DEFAULT_PARAMS_INSTANCE_URL=http://localhost:8080
ldr-web
```

### Paso 2: configura dependencias

Abre `http://localhost:5000`, crea tu cuenta local e inicia sesión. En Settings selecciona Ollama, el modelo `gemma3:12b` y SearXNG. La variable anterior fija y autoriza su dirección local antes del arranque. Envía una pregunta pública pequeña, por ejemplo «¿Qué es SearXNG?», y abre el informe al terminar. El proceso `ldr-web` debe permanecer abierto durante la prueba.

## Comprobación

El informe debe incluir fuentes que puedas abrir y que respalden sus afirmaciones. Revisa qué proveedores recibieron la consulta antes de usar información privada.

## Si algo falla

Si una búsqueda local está bloqueada, consulta la guía de SearXNG y sus restricciones de direcciones aprobadas. Si falla inferencia, prueba primero el proveedor configurado por separado.