Contenido detallado
🖼️ Por qué una interfaz gráfica
El terminal fue ideal para tu primer «hola»: demuestra que el modelo funciona. Pero para usar de verdad en el día a día cansa: sin historial, sin cambiar de modelo fácilmente, sin pegar un PDF. Una interfaz gráfica resuelve eso y te da un ChatGPT que vive en tu máquina.
🆕 ¿Eres nuevo por aquí?
"Interfaz gráfica" (GUI) es la ventana con botones, cuadros de texto y menús: lo opuesto a la terminal de línea de comandos. "Backend" es la pieza invisible que hace el trabajo pesado (aquí, el Ollama ejecutando el modelo); la interfaz solo se comunica con él y muestra el resultado de forma atractiva en la pantalla.
✗ Solo terminal
- ✗Cerraste la ventana, perdiste la conversación
- ✗Cambiar de modelo = volver a escribir el comando
- ✗No puedes adjuntar archivos ni imágenes
- ✗Nada de buscar en chats antiguos
✓ Interfaz gráfica
- ✓Historial guardado y con opción de búsqueda
- ✓Menú para cambiar de modelo con un clic
- ✓Adjuntar documentos, imágenes y código
- ✓Varios chats abiertos uno al lado del otro
🌐 Open WebUI: qué es
O Open WebUI es una interfaz web de código abierto que se conecta a Ollama —o a cualquier API compatible con la de OpenAI— y te ofrece una pantalla de chat completa. Funciona en tu propia máquina y se abre en el navegador, normalmente en localhost:3000.
🆕 ¿Eres nuevo por aquí?
"Front-end web" es la parte que ves y en la que haces clic, presentada como una página de internet. "localhost" es un apodo para la tu propia máquina — cuando abres localhost:3000, nada sale a internet; el navegador solo se comunica con un programa que se ejecuta ahí mismo, en el puerto 3000.
🔑 La idea central
Open WebUI separa quién muestra de quién piensa:
- •Open WebUI se encarga de la interfaz: chats, historial, archivos adjuntos, inicio de sesión.
- •Ollama se encarga del cerebro: carga el modelo y genera el texto.
- •Los dos se comunican por una API local, y todo sigue en tu máquina, sin conexión.
📋 Lo que te ofrece de inmediato
- Chat con historial, organización por carpetas y búsqueda.
- Cambia de modelo desde el menú (aparecen todos los que descargaste en Ollama).
- Admite varios usuarios con inicio de sesión: útil para la familia o el equipo.
- Carga de documentos para hacerles preguntas (la base del RAG, tema del módulo 3.6).
🐳 Iniciar con Docker
La forma más limpia de instalar Open WebUI es con Docker. Un comando descarga la aplicación completa, ya lista, y la pone en marcha — sin modificar las dependencias de tu sistema.
🆕 ¿Eres nuevo por aquí?
"Docker" empaqueta un programa con todo lo que necesita en una "caja" aislada (un container). No instalas biblioteca por biblioteca: ejecutas el contenedor y funciona igual en cualquier máquina. Instala el Docker Desktop (Windows/macOS) o el Docker Engine (Linux) antes de continuar.
Ollama ya en ejecución
Asegúrate de que Ollama del módulo 3.1 esté activo (ollama list muestra tus modelos). Es el backend que usará la interfaz.
Ejecutar el contenedor
Un solo docker run descarga la imagen e inicia Open WebUI ya conectado al Ollama de tu máquina.
Abrir en el navegador
Accede localhost:3000, crea la primera cuenta (se convierte en admin) y empieza a conversar.
⌨️ Ejemplo práctico: iniciar Open WebUI
Objetivo: poner en marcha la interfaz de chat conectada a tu Ollama. Pega en la terminal (una sola línea).
Leyendo el comando: -d se ejecuta en segundo plano · -p 3000:8080 abre el puerto 3000 en tu PC · --add-host dejar que el contenedor encuentre Ollama en la máquina anfitriona · -v open-webui:... guarda tus chats aunque se reinicie el contenedor.
Cómo verificar: abre http://localhost:3000 en el navegador. ¿Apareció la pantalla para crear una cuenta? Está en línea. Ejecuta docker ps y comprueba el contenedor open-webui con estado Arriba.
💡 Consejo práctico
En Linux, si el contenedor no puede ver Ollama, ejecuta Ollama con OLLAMA_HOST=0.0.0.0 para que acepte conexiones de la red de Docker. Para actualizar la interfaz después: docker pull ghcr.io/open-webui/open-webui:main y vuelve a crear el contenedor; tus chats quedan guardados en el volumen.
🖥️ LM Studio: alternativa de escritorio
No todo el mundo quiere trabajar con Docker. El LM Studio es una aplicación de escritorio que instalas como cualquier programa: descarga modelos en el formato GGUF, incluye un chat y además activa un servidor local, todo en una sola ventana.
🆕 ¿Eres nuevo por aquí?
"GGUF" es el formato de archivo en el que vienen empaquetados los modelos abiertos para ejecutarse en CPU/GPU; profundizarás en esto en el módulo 3.3. "Servidor local integrado" quiere decir que LM Studio también ofrece una API en tu máquina, igual que Ollama, para que tus apps se conecten.
✓ Prefiere LM Studio cuando
- ✓Quieres hacer clic e instalar, sin terminal ni Docker
- ✓Te gusta explorar y descargar modelos GGUF desde una tienda visual
- ✓Quieres ajustar parámetros con controles deslizantes y ver el efecto al instante
- ✓Te basta con el chat y el servidor local en la misma ventana
⚙️ Prefiere Ollama + Open WebUI cuando
- •Quieres ejecutarlo como servicio siempre activo, sin tener la app abierta en pantalla
- •Necesitas varios usuarios con inicio de sesión en el navegador
- •Vas a acceder desde otros dispositivos a través de la red (Tailscale)
- •Quieres crear scripts para todo desde la línea de comandos
🤝 No es «una cosa o la otra»
Los dos caminos llegan al mismo lugar: un modelo local con chat y API. Mucha gente usa LM Studio para experimentar y comparar modelos en el escritorio, y el Ollama + Open WebUI para el laboratorio que queda encendido y da servicio a toda la casa. Empieza por lo que hoy te resulte más sencillo.
🔌 Conectando interfaz ↔ backend
Con Open WebUI en marcha, falta apuntar la interfaz al backend correcto. Cuando Ollama está en la misma máquina, suele funcionar a la primera; si algo no aparece, casi siempre es la URL de conexión.
Apuntar a Ollama
En Configuración → Conexiones, la URL de Ollama debe ser http://host.docker.internal:11434 (interfaz en Docker) o http://localhost:11434 (instalación directa).
Elegir el modelo
En la parte superior del chat, el selector muestra todos los modelos que descargaste (ollama pull). Alterna entre un qwen2.5:7b y un gemma2:2b sin reiniciar nada.
Definir el system prompt
En la configuración del modelo (o del chat) escribes el system prompt — la instrucción de fondo que define la personalidad y las reglas: «responde en PT-BR, de forma concisa y con ejemplos». Tema que se profundiza en el módulo 3.4.
🧭 Si un modelo no aparece
- Confirma que existe: ollama list en la terminal.
- Confirma que Ollama responde: curl http://localhost:11434/api/tags debe devolver la lista.
- En Open WebUI, revisa la URL de conexión y haz clic en verificar/actualizar.
🚀 Recursos que permiten un uso real
La interfaz no es solo estética: abre puertas que el terminal no tenía. Antes de enumerar los recursos, fija el modelo mental de la pila — navegador → Open WebUI → Ollama → modelo, una capa dentro de otra:
Lee de afuera hacia adentro: todo sucede en tu navegador. O Open WebUI recibe tu pregunta y la entrega a Ollama, que activa el modelo (en morado). La respuesta vuelve por la capa cian hasta la pantalla. Ninguna flecha sale de la máquina.
🎯 Qué habilita la interfaz
- •Múltiples chats: una conversación por tema, organizadas y fáciles de buscar.
- •RAG de documentos: sube PDFs y pregúntales sobre su contenido — la base del módulo 3.6.
- •Perfiles de prompt: guarda system prompts reutilizables ("revisor", "traductor", "tutor").
- •Usuarios: cuentas separadas con inicio de sesión: toda la casa o el equipo usando un solo lab.
Autoevaluación (opcional): en Open WebUI, ¿quién es el backend ¿que realmente genera el texto?
📌 Resumen del módulo
Siguiente módulo:
3.3 — Eligiendo y descargando el modelo adecuado