Saltar al contenido principal

🖥️ Aplicación de escritorio

La aplicación de escritorio Libre WebUI incorpora la interfaz web en una ventana nativa para macOS, Windows y Linux. Se conecta a un servidor Libre WebUI que se ejecute en el mismo equipo o a cualquier servidor que indiques.

La aplicación se desarrolla en su propio repositorio, y los instaladores de cada versión se adjuntan a las versiones de GitHub del repositorio principal.

📦 Descargar e instalar​

Descarga el paquete de tu plataforma desde la última versión:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg o .zip, o brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (instalador) o Libre-WebUI-Desktop-{version}.exe (portátil)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage o Libre-WebUI-Desktop-{version}-{arch}.deb

Antes del cambio de nombre, estos recursos se publicaban con el prefijo Libre-WebUI-Frontend y el paquete de la aplicación se llamaba Libre WebUI Frontend.app.

macOS bloquea la aplicación por estar dañada​

Libre WebUI utiliza temporalmente una firma ad hoc en las compilaciones de macOS. Mantiene la validez estructural del paquete, pero no identifica al editor ante Apple ni permite la notarización. Después de copiar la aplicación a Aplicaciones, autorízala en Ajustes del Sistema → Privacidad y seguridad → Abrir igualmente.

Si macOS no ofrece esa opción, elimina el atributo de cuarentena solo tras comprobar que la aplicación procede de la versión oficial de Libre WebUI:

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

No desactives Gatekeeper globalmente. Una distribución fluida sigue requiriendo un certificado Developer ID Application y la notarización de Apple.

🔌 Conectarse a un servidor​

La aplicación es un cliente y necesita un servidor Libre WebUI. La primera vez que se abre, una pantalla inicial ofrece dos opciones:

  • Local: busca un servidor en el equipo (puerto 3001, predeterminado para la imagen Docker y npx libre-webui) y se conecta cuando responde su comprobación de estado.
  • Remoto: introduce la URL de cualquier servidor Libre WebUI accesible, como un laboratorio doméstico o un despliegue de equipo. La aplicación lo verifica antes de conectarse.

La elección se recuerda. Para cambiar de servidor, utiliza Libre WebUI → Cambiar de servidor… en la barra de menús. Si un servidor guardado deja de responder, la aplicación vuelve a la pantalla inicial en lugar de mostrar una ventana vacía.

Para ejecutar un servidor local, consulta Inicio rápido: funcionan Docker Compose, npx libre-webui y Homebrew.

🧰 Work en la aplicación de escritorio​

El paquete de escritorio no incluye el backend, Docker ni un entorno de contenedores para Work. Su disponibilidad depende del servidor:

  • un backend nativo capaz de ejecutar docker info puede crear contenedores y volúmenes con nombre de Work para cada tarea;
  • el despliegue Compose estándar proporciona Work mediante Docker al montar el socket del host, mientras que un contenedor personalizado sin un entorno accesible lo marca como no disponible;
  • un servidor Kubernetes proporciona Work mediante Pod/PVC cuando el chart Helm se instala con work.enabled=true;
  • la aplicación sigue admitiendo Chat cuando Work no está disponible.

Los archivos de Work residen en el host Docker o almacenamiento Kubernetes del servidor, no en la aplicación. Las vistas previas viajan por el proxy firmado del mismo origen de Libre WebUI, por lo que los clientes locales y remotos pueden usarlas si el proxy inverso conserva el tráfico HTTP y WebSocket.

🎨 Integración con el escritorio​

  • Barra de menús nativa con menús de aplicación, edición, vista, ventana y ayuda
  • Barra de título personalizada de macOS (hiddenInset) con los controles de ventana en la barra lateral
  • El modo oscuro sigue las preferencias del sistema
  • Los enlaces externos se abren en el navegador predeterminado, nunca dentro de la aplicación
  • El renderizador se ejecuta con aislamiento de contexto y sin integración de Node

🚧 Limitaciones​

  • Arquitectura de macOS: los paquetes actuales solo admiten Apple Silicon (arm64)
  • Requiere un servidor: la aplicación no incluye el backend
  • Work depende del entorno del servidor: no se incluye Docker ni Kubernetes
  • Sin actualizaciones automáticas: hay que descargar un paquete nuevo

Consulta Work: espacios de trabajo aislados para conocer los detalles del entorno, proveedor, almacenamiento y seguridad de las vistas previas.