Cómo instalar Open WebUI y usar tus modelos de LiteLLM desde el navegador

Open WebUI es una interfaz web gratuita, muy parecida a ChatGPT, que funciona en tu propio ordenador. Desde ella puedes conversar con cualquier modelo de inteligencia artificial, subir documentos, guardar tus conversaciones y crear cuentas para otras personas de tu casa o tu equipo.

En esta guía vas a instalar Open WebUI y a conectarlo a LiteLLM, la centralita que reúne todos tus modelos (Ollama, LM Studio, OpenRouter...). Así, desde una sola pantalla, podrás elegir cualquiera de ellos.

Antes de empezar

Para seguir esta guía necesitas tener LiteLLM instalado y funcionando, con su clave maestra a mano. Si todavía no lo tienes, sigue primero nuestra guía «Cómo instalar y configurar LiteLLM para reunir todos tus modelos de IA».

También necesitas:

• Un ordenador con Mac, Windows 10/11 o Linux.
• Unos 5 GB libres en disco.
• Conexión a Internet para la instalación.

Qué forma de instalación elegir

Open WebUI se puede instalar de varias maneras. En esta guía explicamos dos:

• Con uv (recomendada para empezar). Usa la misma herramienta que ya instalaste para LiteLLM. No necesitas instalar nada más.
• Con Docker. Docker es un programa que ejecuta aplicaciones dentro de «contenedores» aislados. Es la forma más habitual en servidores, pero exige instalar Docker Desktop. Explicamos esta opción al final.

Paso 1. Abrir la terminal

• Mac: pulsa ⌘ + Espacio, escribe «Terminal» y pulsa Intro.
• Windows: abre el menú Inicio, escribe «PowerShell» y pulsa Intro.
• Linux: pulsa Ctrl + Alt + T.

Comprueba que tienes uv instalado:

uv --version

Si ves un número de versión, continúa. Si no, instálalo como se explica en el paso 2 de la guía de LiteLLM.

Paso 2. Instalar y arrancar Open WebUI

Con uv, una sola orden descarga Open WebUI y lo arranca. Le indicamos además una carpeta fija (DATA_DIR) para guardar tus datos: conversaciones, usuarios y ajustes.

Mac y Linux

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Windows

$env:DATA_DIR="$HOME\.open-webui"; uvx --python 3.11 open-webui@latest serve

La primera vez tarda varios minutos: descarga Open WebUI, una versión adecuada de Python y algunos componentes que usa para leer documentos. Verás muchas líneas de texto en la terminal. Cuando aparezca un mensaje como Application startup complete o Uvicorn running on http://0.0.0.0:8080, estará listo.

Paso 3. Crear tu cuenta de administrador

1. Abre tu navegador y entra en:

http://localhost:8080

2. Verás una pantalla de bienvenida («Get started with Open WebUI»). Pulsa para empezar.
3. Rellena tu nombre, tu correo y una contraseña, y pulsa Create Admin Account.

La primera cuenta que se crea es la del administrador. Después, el registro de nuevas cuentas se desactiva automáticamente: nadie más podrá crearse una cuenta sin tu permiso.

Paso 4. Poner la interfaz en español

Si la interfaz aparece en inglés:

1. Haz clic en tu nombre o avatar (abajo a la izquierda) y elige Settings.
2. En General, busca Language y elige Español.

Paso 5. Conectar Open WebUI con LiteLLM

Antes de este paso, asegúrate de que LiteLLM está funcionando en otra ventana de la terminal (con litellm --config config.yaml dentro de su carpeta).

1. Haz clic en tu nombre o avatar y abre el Panel de administración (Admin Panel).
2. Entra en Configuración (Settings) y después en Conexiones (Connections). En algunas versiones el camino es Settings → Admin → Connections: el nombre de la sección es el mismo.
3. En el apartado API de OpenAI (Manage OpenAI API Connections), pulsa el botón + para añadir una conexión.
4. Rellena los campos:

• URL: http://localhost:4000/v1
• Clave (API Key): tu clave maestra de LiteLLM, la que empieza por sk-.

5. Pulsa Guardar (Save).

Open WebUI pedirá a LiteLLM su lista de modelos y los añadirá automáticamente. No tienes que escribirlos uno a uno.

Paso 6. Tu primera conversación

1. Pulsa Nuevo chat (New Chat), arriba a la izquierda.
2. En la parte superior verás el selector de modelo. Despliégalo: aparecerán los nombres que diste a tus modelos en LiteLLM, por ejemplo gemma-local, lmstudio-gemma o qwen-gratis.
3. Elige uno, escribe tu mensaje y pulsa Intro.

Puedes cambiar de modelo en cualquier momento desde el mismo selector.

Cosas útiles que puedes hacer

• Hacer preguntas sobre un documento: arrastra un PDF o un archivo de texto a la caja del mensaje y pregunta sobre su contenido.
• Comparar modelos: en el selector de modelo, el botón + permite añadir un segundo modelo a la misma conversación. Los dos responderán a la vez y podrás comparar sus respuestas.
• Crear cuentas para otras personas: desde el Panel de administración → Usuarios puedes añadir usuarios y decidir qué modelos puede usar cada uno.
• Buscar en tus conversaciones: todas se guardan en la barra lateral y se pueden buscar.

Cómo volver a arrancarlo otro día

Open WebUI funciona mientras su ventana de terminal esté abierta. Para usarlo otro día:

1. Arranca LiteLLM (y Ollama o LM Studio, si los usas).
2. Abre una terminal y repite la orden del paso 2. Esta vez arrancará en pocos segundos.
3. Entra en http://localhost:8080 e inicia sesión.

Tus conversaciones y ajustes siguen ahí, porque se guardan en la carpeta .open-webui.

Alternativa: instalarlo con Docker

Si ya usas Docker, o quieres que Open WebUI arranque solo con el ordenador, esta es la forma habitual.

1. Instala Docker Desktop desde docker.com (Mac y Windows) o Docker Engine en Linux. En Windows, Docker Desktop utiliza WSL 2: acepta su instalación si te la propone.
2. Abre Docker Desktop y espera a que indique que está en marcha.
3. En la terminal, ejecuta esta orden (es una sola línea):

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=cambia-esto-por-una-frase-larga --name open-webui --restart always ghcr.io/open-webui/open-webui:main

4. Espera uno o dos minutos y entra en http://localhost:3000.

Dos diferencias importantes con la instalación con uv:

• La dirección es http://localhost:3000 en lugar de http://localhost:8080.
• Dentro de Docker, «localhost» se refiere al propio contenedor, no a tu ordenador. Por eso, en el paso 5 la URL de LiteLLM debe ser http://host.docker.internal:4000/v1.

Problemas frecuentes

• La primera vez tarda mucho en arrancar. Es normal: está descargando componentes. Espera al mensaje de inicio completado.
• El navegador no abre localhost:8080. Comprueba que la ventana de la terminal sigue abierta y sin errores. Si el puerto está ocupado, añade --port 8081 al final de la orden del paso 2 y entra en http://localhost:8081.
• No aparece ningún modelo en el selector. Comprueba que LiteLLM está en marcha y que la clave de la conexión es exactamente tu clave maestra. En Conexiones, edita la conexión: si hay un botón de verificación, te dirá si LiteLLM responde.
• Error de conexión con Docker. Usa http://host.docker.internal:4000/v1 en lugar de localhost.
• Un modelo aparece pero da error al responder. El problema está entre LiteLLM y ese modelo: comprueba que Ollama o LM Studio están abiertos, o que no has superado el límite de un modelo gratuito de OpenRouter.
• En un Mac con chip Apple, el contenedor de Docker se queda colgado. Si tienes configurada la variable DOCKER_DEFAULT_PLATFORM=linux/amd64, añade --platform linux/arm64 a la orden de Docker.

Siguientes pasos

Ya tienes tu propio ChatGPT con todos tus modelos. En las siguientes guías de la serie verás cómo usar esos mismos modelos desde el editor de código Cursor y cómo añadir a Open WebUI el nuevo modelo de IA integrado en macOS.

Siguiente guía: Cómo usar Cursor con modelos de pago de OpenRouter y modelos gratuitos de LiteLLM