Skip to main content

OpenWebUI: Interfaz web para IA, similar a ChatGPT


Introducción

OpenWebUI es una interfaz web pensada para interactuar con modelos de inteligencia artificial de forma centralizada. Su objetivo es servir como punto de acceso donde se pueden unificar distintos proveedores o backends de modelos, ya sea corriéndolos en la propia máquina o consumiendo APIs externas. En este documento se explica cómo ponerlo en marcha usando Docker y docker-compose, partiendo de un archivo de configuración ya preparado.

Nota importante: Este procedimiento cubre únicamente la instalación de la interfaz web. No incluye la configuración de los modelos en sí, que pueden añadirse después según las necesidades de cada caso (locales o remotos). Para ejemplos prácticos de integración se indican artículos relacionados al final.


Acceder a la interfaz

El archivo docker-compose.yml con toda la configuración básica se encuentra disponible en el repositorio: 🔗 docker-compose.yml en Gitea

Con el archivo descargado en el sistema, basta con ejecutar el siguiente comando para levantar el servicio:

docker-compose up -d

Este comando descarga la imagen oficial (si no está previamente en la máquina) y crea el contenedor en segundo plano. Al terminar, se puede comprobar que está activo ejecutando docker ps y verificando que aparece la entrada correspondiente a OpenWebUI.

Para acceder desde un navegador web, hay que abrir la siguiente dirección:

http://localhost:2960

Al cargarla debería mostrarse la interfaz principal de OpenWebUI. Desde ahí se podrá gestionar el acceso, añadir cuentas de usuario y posteriormente configurar los proveedores de modelos que se vayan a utilizar.


Ejecutar modelos: integración local o por API

OpenWebUI no incluye ningún modelo de inteligencia artificial por defecto. Para empezar a utilizarlo hay que conectar un backend de modelos, bien sea ejecutando uno en el propio equipo o integrando un servicio externo. Existen dos caminos principales:

  1. Ejecución local: si se dispone de hardware compatible se puede enlazar OpenWebUI con un servidor local de modelos. Ejemplo práctico:

  2. APIs externas: es posible conectar OpenWebUI con servicios de terceros para aprovechar sus modelos sin necesidad de ejecutarlos en casa. Ejemplos:

De esta manera, la interfaz se adapta tanto a escenarios caseros con recursos limitados como a despliegues que hacen uso de APIs comerciales.


Notas finales

  • Gestión del contenedor:

    • Ver el estado actual de los contenedores con docker ps.
    • Reiniciar el servicio con docker restart OpenWebUI.
    • Detenerlo por completo con docker stop OpenWebUI.
  • Modificar configuración: si se cambian puertos, volúmenes u opciones del contenedor, basta con editar el archivo docker-compose.yml y volver a aplicarlo:

    docker-compose down && docker-compose up -d
    
  • Persistencia de datos: los volúmenes indicados en el docker-compose permiten que los datos de configuración y sesiones se mantengan entre reinicios. Si se quiere limpiar todo el entorno, hay que borrar manualmente esas carpetas además de bajar el contenedor.


Referencias o enlaces de interés