# Instrucciones para el agente: Open WebUI: aloja un espacio de conversación con modelos

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/open-webui/open-webui (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/open-webui-selfhosted

---

## 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 el intérprete del entorno elegido es Python 3.12 y que pip instala allí. En macOS/Linux, crea y activa un entorno con `python -m venv .venv` y `source .venv/bin/activate` antes de instalar. Antes de arrancar `open-webui serve`, para una primera prueba concreta carga `OPENAI_API_KEY` desde el entorno privado de esa terminal y fija `OPENAI_API_BASE_URL=https://api.openai.com/v1`. Estas variables están respaldadas por el [código de configuración](https://github.com/open-webui/open-webui/blob/main/backend/open_webui/config.py). La clave y el destino deben corresponder a la misma cuenta/proveedor.

La ruta Python documentada es:

```bash
pip install open-webui
open-webui serve
```

Mantén el servidor abierto, visita `http://localhost:8080` y crea la cuenta inicial. Selecciona en el desplegable un modelo de esa cuenta y envía «Responde con un saludo en español». Debe aparecer una respuesta en la conversación y el nombre del modelo elegido. Esta ruta usa inferencia remota; para Ollama sigue la alternativa local del README.

## Comprobación

Envía una consulta de prueba y confirma el modelo seleccionado. Si añades documentos, comprueba permisos con un usuario de prueba.

## Si algo falla

Comprueba por separado la disponibilidad del servidor y la conexión al proveedor de inferencia.