Inicio rápido
Requisitos
| Requisito | Mínimo | Recomendado |
|---|---|---|
| Node.js | 22.22+ | Última versión LTS |
| RAM | 8 GB | 16 GB+ |
| Disco | 5 GB | 20 GB+ para modelos |
| GPU | Opcional | 8 GB+ de VRAM para inferencia local rápida |
| Docker | Opcional | Necesario para las tareas de Work |
Libre WebUI funciona con Ollama solo mediante CPU, aunque los modelos más pequeños se adaptan mejor a ella. Para los plugins de proveedores en la nube, solo necesitas la clave API correspondiente.
El chat, los documentos, los artefactos y las funciones respaldadas por proveedores no necesitan Docker.
Work sí: Docker debe estar instalado en la máquina que ejecuta el backend de
Libre WebUI, y el proceso del backend debe poder invocarlo. El comando
npx libre-webui no instala Docker. Si Docker no está disponible, el resto de
Libre WebUI sigue funcionando mientras Work muestra Entorno de ejecución no disponible;
los comandos del modelo nunca se ejecutan directamente en el host como alternativa.
Iniciar Libre WebUI
npx libre-webui@latest
Abre http://localhost:8080. Crea la primera cuenta;
esa cuenta se convertirá en administradora. Los registros públicos posteriores
permanecen desactivados salvo que definas explícitamente ENABLE_SIGNUP=true.
El lanzador empaquetado conserva el estado persistente en ~/.libre-webui. Define
un DATA_DIR absoluto para elegir otra ubicación; los valores relativos se resuelven
desde el directorio donde ejecutes npx.
Instalar Ollama
Instala Ollama y descarga un modelo general pequeño:
ollama pull gemma4:12b
Otras opciones potentes son gemma4:26b (MoE), gemma4:31b (dense) y qwen3.8:27b. Usa el Gestor de modelos de Libre WebUI para consultar los modelos instalados, buscar en la biblioteca de Ollama en directo y descargar modelos sin salir de la aplicación.
Para la búsqueda semántica en documentos, instala también un modelo de embeddings:
ollama pull nomic-embed-text
Añadir proveedores en la nube
Los proveedores en la nube son opcionales. Añade las claves por usuario en Ajustes → Claves API, o
para todo el servidor en backend/.env (reinicia después el backend), y activa el
proveedor en Ajustes:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
La aplicación actualiza las listas de modelos de los proveedores cuando estos lo admiten. No necesitas mantener abierta la documentación para conocer los nombres de modelos más recientes.
Iniciar tu primera tarea de Work
Work asigna a cada tarea una conversación persistente y un sistema de archivos independiente respaldado por un contenedor. Está disponible para administradores autenticados.
- Instala e inicia Docker en la máquina que ejecuta el backend de Libre WebUI.
- Inicia una tarea desde el botón Work del encabezado de la barra lateral, el menú
+de la barra de pestañas, la página Inicio oCmd/Ctrl + Shift + U. - Elige un modelo que admita llamadas a herramientas.
- Describe lo que quieres crear o cambiar y selecciona Ejecutar.
- Sigue el resultado en las pestañas Archivos, Actividad, Git, Terminal y Vista previa del panel del espacio de trabajo.
La tarea permanece en la barra lateral para que puedas volver más tarde a la misma conversación y a sus archivos. Detener una ejecución o una vista previa conserva el espacio de trabajo. Eliminar la tarea elimina definitivamente su espacio de trabajo.
Work puede usar un modelo Ollama instalado, un modelo de Ollama Cloud o un plugin configurado de un proveedor de chat o completado. Cuando seleccionas un proveedor remoto, Libre WebUI muestra un aviso antes de la ejecución: el proveedor recibe la conversación, las definiciones de herramientas y los resultados de herramientas solicitados por el modelo. Una ejecución autónoma puede realizar varias llamadas de pago al proveedor.
Consulta Work: espacios de trabajo aislados para conocer los detalles del entorno de ejecución, la persistencia, la red, la vista previa y la seguridad.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Crea el primer administrador en el navegador. No hacen falta una opción de registro ni un reinicio; los registros públicos posteriores están cerrados de forma predeterminada.
Si Ollama ya se ejecuta en el host o en otra máquina:
docker compose -f docker-compose.external-ollama.yml up -d
Para acelerar mediante una GPU NVIDIA, usa el archivo Compose para GPU incluido en el repositorio.
Los archivos Compose del repositorio montan el socket Docker del host para que Work esté disponible
cuando Docker está instalado. Esto concede a la aplicación un control del host equivalente a root,
así que lee primero Work: espacios de trabajo aislados. En Linux, define
DOCKER_GID en .env con el grupo propietario del socket. Retira el montaje si
no quieres usar Work.
El Ollama incluido también es solo interno. Añade
-f docker-compose.ollama-host.yml únicamente cuando otro proceso del host necesite su API;
la sustitución se vincula a loopback de forma predeterminada.
Orientarse en la aplicación
La pestaña Inicio tiene tres secciones: Empezar (nuevo chat, chat de incógnito, nueva
tarea de Work), Continuar (tus conversaciones y tareas recientes) y Explorar
(Notas, Calendario, Automatizaciones, Modelos, Personas, Imagine). Los mismos
destinos aparecen en la fila de navegación de la barra lateral y en la paleta de comandos
(Cmd/Ctrl + K), que realiza búsquedas aproximadas en tus chats, tareas de Work y acciones
de la aplicación, así como búsquedas de texto completo en mensajes, notas y documentos.
- Calendario — un calendario por usuario con eventos recurrentes.
- Automatizaciones — ejecuciones de IA programadas que se entregan como sesiones de chat.
Atajos de teclado
| Atajo | Acción |
|---|---|
Cmd/Ctrl + K | Paleta de comandos (funciona mientras escribes) |
Cmd/Ctrl + Shift + O | Nuevo chat |
Cmd/Ctrl + Shift + U | Nueva tarea de Work |
Cmd/Ctrl + B | Mostrar u ocultar la barra lateral |
Cmd/Ctrl + , | Ajustes |
Cmd/Ctrl + D | Cambiar el tema |
? | Abrir Ajustes en la pestaña Atajos |
Esc | Cerrar la ventana de ajustes |
Enter | Enviar mensaje |
Shift + Enter | Nueva línea |