Saltar al contenido principal

Consejos avanzados

Esta página reúne flujos de trabajo prácticos que hacen que Libre WebUI resulte más rápido, ordenado y fiable en el uso diario.

Mantener cargado un modelo pequeño para el día a día​

Usa un modelo local rápido para el trabajo habitual y cambia a modelos más grandes solo cuando la tarea lo requiera.

Buenos ejemplos para uso diario:

  • gemma4:12b para chats cotidianos rápidos
  • qwen3.8:27b para trabajo general más exigente
  • gemma4:26b para aprovechar la eficiencia de MoE en hardware más potente
  • gemma4:31b para obtener la mejor calidad local con un modelo dense
  • nomic-embed-text para embeddings de documentos

Abre Modelos para ver cuáles están en ejecución. Descarga de memoria los modelos que no utilices cuando escasee la VRAM.

Nombrar chats nuevos mientras se genera la respuesta​

Marca Habilitar título automático y elige un Modelo de tarea en Configuración → Predeterminados. En un chat nuevo guardado, la generación del título resume tu primer mensaje en cuanto lo envías, junto con la respuesta del asistente. La barra lateral se actualiza cuando el título está listo; una solicitud de título lenta no bloquea la respuesta.

El modelo de tarea y el proveedor seleccionados atienden la solicitud del título. Un proveedor que serializa las solicitudes puede ponerla en cola de todos modos. Los mensajes posteriores, los chats que ya has nombrado y los chats de incógnito no generan títulos automáticos.

Seguir el razonamiento en directo​

Cuando Habilitar título automático está marcado y hay un Modelo de tarea seleccionado en Configuración → Predeterminados, el bloque de razonamiento plegado muestra un breve resumen de actividad mientras el asistente razona. Ese mismo modelo de tarea recibe el último fragmento de razonamiento para describir el tema actual, así que elige un modelo local si ese texto debe permanecer en tu equipo.

Los resúmenes usan como máximo los últimos 4000 caracteres, empiezan cuando hay suficiente texto disponible y se actualizan como mucho una vez cada cinco segundos, con una sola solicitud en curso. Un resumen lento o fallido nunca bloquea la respuesta. El último resumen sigue visible en ese mensaje ya renderizado cuando termina el razonamiento, junto a su duración; despliega el bloque para leer el razonamiento original. Estos resúmenes son temporales y no se guardan en el historial del chat.

El texto de actividad se anima al cambiar, con el mismo indicador de carga que los títulos de chat pendientes. Las preferencias de movimiento reducido desactivan ambas animaciones. Los chats de incógnito y los chats sin un modelo de tarea habilitado mantienen la etiqueta de razonamiento habitual sin realizar solicitudes de resumen.

Usar el chat de incógnito para conversaciones que no deban persistir​

Inicia un chat de incógnito desde el menú + de la barra de pestañas, la paleta de comandos, la página Inicio o el botón fantasma de la pantalla de bienvenida del chat. También tiene una URL directa: /chat?incognito=1.

Un chat de incógnito nunca persiste: no se crea ninguna sesión en el servidor, no se guarda ningún mensaje y nunca aparece en la barra lateral ni en el historial. El chat muestra un aviso de Modo privado («Esta conversación no se guardará»). Abrir un chat guardado abandona el modo de incógnito; recargar una pestaña de incógnito inicia un chat privado nuevo y vacío, por lo que desaparecen los turnos anteriores.

Ten claro el límite: el modo de incógnito controla la persistencia, no la exposición al proveedor. El modelo seleccionado —local o remoto— sigue recibiendo toda la conversación, y el contexto documental sigue aplicándose cuando está activado. Para una conversación que no deba abandonar tu infraestructura, combina el modo de incógnito con un modelo Ollama local.

Usar la barra lateral compacta​

La barra lateral compacta mantiene accesos directos a Canales, Notas, Calendario, Automatizaciones, Personas e Imagine debajo de Chat y Work, y la búsqueda al final. El acceso a Agentes aparece cuando la función está habilitada para tu cuenta. Pasa el puntero sobre un icono para ver su etiqueta; el destino actual permanece resaltado. En pantallas cortas, desplaza los accesos directos mientras los controles de ajustes y de cuenta se mantienen abajo.

Desplazarse por los paneles​

Las listas de Chat y Work se difuminan suavemente en los bordes donde hay más elementos disponibles. El difuminado desaparece al principio y al final de la lista, y las listas que caben por completo se ven íntegras. El foco del teclado mantiene la lista nítida para que los controles sigan siendo legibles.

La barra de pestañas superior usa el mismo difuminado en los bordes de su desplazamiento horizontal. El difuminado desaparece cuando todas las pestañas caben o cuando llegas a cualquiera de los extremos. Al seleccionar una pestaña, esta se muestra a la vista, y el botón de pestaña nueva permanece totalmente visible junto a la tira de pestañas.

El mismo efecto acompaña al desplazamiento en los ajustes, en Chat, en Work, en las páginas de biblioteca, en los menús y en el contenido de los diálogos, incluidas las listas horizontales y las tablas. Los ajustes mantienen su título y su campo de búsqueda por encima de la navegación que se desplaza. Los difuminados se actualizan cuando se carga contenido, cambian los filtros o se redimensiona la ventana, y funcionan en todos los temas y en las disposiciones de derecha a izquierda. La navegación con teclado elimina el difuminado alrededor de los controles enfocados; volver al ratón o al táctil lo restaura. Los campos de texto y el interior de las aplicaciones integradas y de los widgets de terminal o editor conservan su propio renderizado.

Chat y Work usan un difuminado más ancho para el contenido antiguo en la parte superior y debajo de sus botones Nuevos mensajes y Nueva actividad cuando te desplazas hacia arriba. Esos botones se mantienen nítidos sobre el texto difuminado y te devuelven al contenido más reciente, donde el difuminado inferior desaparece.

Gestionar pestañas con el menú contextual​

Haz clic con el botón derecho en una pestaña (o pulsa Shift + F10 cuando tenga el foco) para:

  • Cerrar pestaña
  • Cerrar las demás pestañas
  • Cerrar las pestañas a la derecha
  • Cerrar todas las pestañas

Inicio siempre es la primera pestaña y no puede cerrarse. Los administradores pueden fijar Sistema, Uso del proveedor y Evaluaciones en el pie de la barra lateral con el icono de chincheta del menú del avatar. La administración de cuentas está en Configuración → Gestión de usuarios.

Moverse rápidamente con la paleta de comandos​

Cmd/Ctrl + K abre la paleta de comandos desde cualquier parte, incluso cuando el editor tiene el foco. Busca de forma aproximada entre las acciones de la aplicación, tus chats y tus tareas de Work, por lo que funcionan consultas parciales o mal escritas: autmtn encuentra Automatizaciones, «imágenes» encuentra Imagine y «oscuro» encuentra el cambio de tema. A partir de tres caracteres, también busca dentro del contenido de mensajes, notas y documentos (incluidas las notas compartidas contigo) y muestra un fragmento por coincidencia. Esta búsqueda se ejecuta sobre tus propios datos descifrados en memoria; no se indexa nada en texto claro en el disco. Los caracteres coincidentes se resaltan, los resultados se ordenan por relevancia y, sin consulta, aparecen tus chats y tareas más recientes. Navega con ↑/↓, abre con Enter y cierra con Esc (o con Cmd/Ctrl + K de nuevo).

Tema predeterminado​

Las instalaciones nuevas usan el tema oscuro, aplicado antes del primer renderizado para evitar un destello claro. Un administrador puede cambiar el valor predeterminado de toda la instancia desde Configuración > Gestión de usuarios > Valores predeterminados > Tema predeterminado (Claro, Oscuro o Negro Puro). Ese valor predeterminado pinta la página de inicio de sesión, se aplica a cada cuenta nueva y rige en cualquier navegador que no haya elegido su propio tema; siempre se respeta una preferencia personal guardada. Libre WebUI no sigue el ajuste de tema del sistema operativo; cámbialo explícitamente mediante Cmd/Ctrl + D, el botón de sol/luna o desde Ajustes. El botón alterna entre Claro, Oscuro, Negro Puro y Celestial.

Celestial sigue al sol: la paleta y un cielo vivo (el sol o la luna en su arco, las nubes, las estrellas tras el anochecer, una lámpara que sigue al puntero de noche) cambian minuto a minuto, y el amanecer y el atardecer se desplazan a lo largo del año. Elígelo en Configuración > Apariencia. El reloj celeste al final de la barra de pestañas abre una vista previa de cristal: arrastra por el día para mover el sol y la luna, o salta directamente al Amanecer o al Atardecer. La misma vista previa está disponible en Apariencia. La vista previa identifica la hora En vivo y una Vista previa seleccionada manualmente, con etiquetas de hora a lo largo del control deslizante. Seguir el reloj, cerrar la vista previa o salir de Apariencia devuelven la hora real. Explorar el día se ejecuta en local y no guarda un ajuste de tema nuevo. Sin ubicación se asume un día de latitud media; comparte tu ubicación (o escribe las coordenadas) y el amanecer y el atardecer se calculan para tu cielo real. La ubicación se redondea a alrededor de un kilómetro, se guarda solo en ese navegador y nunca se envía al servidor. Las coordenadas manuales tienen etiquetas visibles de Latitud y Longitud. La latitud debe estar entre -90 y 90; la longitud, entre -180 y 180. Aplicar o Enter guarda las coordenadas válidas. Las entradas no válidas o incompletas conservan la ubicación guardada; Borrar la elimina explícitamente. Con una ubicación también puedes activar Seguir el clima: las condiciones actuales llegan directamente de Open-Meteo a tu navegador, y las nubes, la lluvia, la nieve, la niebla y el viento dan forma al cielo. Si una solicitud falla, Libre conserva el último clima correcto de la sesión y reintenta automáticamente mientras el tema celestial esté activo. Los reintentos empiezan a los 15 segundos y se espacian hasta una cada cinco minutos como mucho durante una caída. Una solicitud que se queda atascada diez segundos se cancela para que no bloquee las actualizaciones posteriores. Desactivar el clima o cambiar de ubicación cancela las solicitudes pendientes.

Celestial usa el mismo editor de cristal en Chat y en Work. La posición del sol y de la luna se ajusta al tamaño de la pantalla, y la luz que sigue al puntero permanece por debajo de la superficie de lectura. El movimiento decorativo se pausa cuando la pestaña queda oculta y responde de inmediato a la preferencia de movimiento reducido del sistema, incluso durante el barrido de entrada del tema.

Fondo de pantalla de la cuenta​

En Configuración > Apariencia > Imagen de fondo, elige una imagen de hasta 10 MB. Tu imagen original y sus ajustes se guardan en tu cuenta. El fondo aparece en Inicio y en Chat y Work; no pinta la barra lateral, la barra de pestañas ni las páginas de biblioteca.

Tramado crea píxeles cuadrados definidos, con huecos abiertos en las sombras, inspirados en los colores de la imagen. Las zonas claras se suavizan antes de crear los puntos, de modo que los cielos pálidos y las fotos claras conservan textura en lugar de quedar como un tono plano. Original usa una imagen suave y Desenfocado añade un suavizado ajustable. Los tres estilos se funden con el tema actual y adaptan las luces altas para mantener la legibilidad; la imagen subida nunca se modifica. Intensidad se previsualiza al instante y se guarda cuando dejas de ajustarla. Una intensidad de cero oculta el fondo sin eliminarlo. También puedes desactivarlo temporalmente, sustituirlo o quitarlo.

La vista previa funciona con Claro, Oscuro (gris), Negro Puro y Celestial. El fondo sigue visible cuando la navegación se despliega o se pliega. En teléfonos, la barra lateral se superpone a parte del contenido y el fondo que queda descubierto sigue visible. Los fondos de persona siguen siendo propios de sus chats y no sustituyen al fondo de la cuenta. El procesamiento de la imagen se ejecuta en tu navegador. Si una imagen externa no se puede procesar por su política de origen, se usa una alternativa visual local.

Recibir menciones y resultados de automatizaciones por correo​

Una vez que un administrador haya configurado un servidor de correo saliente en Configuración → Gestión de usuarios → Acceso y políticas, abre Configuración → Notificaciones y activa Menciones en canales, Resultados de automatizaciones, o ambas. Una mención llega con la vista previa del mensaje y un enlace al canal; una ejecución de automatización llega con la respuesta que produjo (o el error si falló) y un enlace al chat o a la tarea de Work resultante. Ambas permanecen desactivadas hasta que las actives, y necesitan una dirección de correo en tu cuenta.

Mantener enfocadas las tareas de Work​

Usa una tarea de Work distinta para cada proyecto u objetivo independiente. Cada tarea tiene su propia conversación, una identidad de contenedor gestionada y archivos persistentes. El contenedor puede detenerse o volver a crearse mientras sobrevive su volumen con nombre, por lo que reutilizar una tarea conserva el contexto útil y empezar otra establece un límite limpio.

Una buena instrucción inicial proporciona al modelo:

  • El resultado que quieres.
  • Las restricciones técnicas o de diseño importantes.
  • El comando o comportamiento que debe verificar la finalización.
  • Los archivos o interfaces que deben permanecer sin cambios.

Sigue el progreso en Actividad y después inspecciona y prueba el resultado en Archivos, Git, Terminal y Vista previa. El editor de archivos ofrece resaltado de sintaxis con temas claro y oscuro, borradores sin guardar respaldados por el navegador y formato para los tipos admitidos. Usa Cmd/Ctrl + S para guardar y Shift + Alt + F para dar formato.

Usa un modelo Ollama instalado y capaz de utilizar herramientas cuando quieras que el tráfico del modelo permanezca en tu infraestructura Ollama configurada. Un modelo remoto o en la nube puede reducir la presión sobre la memoria de inferencia local, pero puede realizar varias llamadas facturables y recibe los resultados de herramientas solicitados, que podrían contener datos del espacio de trabajo.

Detener una ejecución o una vista previa conserva el espacio de trabajo. Eliminar una tarea de Work lo borra definitivamente, así que copia antes todo lo que necesites.

Usar personas para trabajos repetibles​

Crea personas para los flujos que repites:

  • Un revisor de código conciso con temperatura baja.
  • Un editor de textos con una guía de estilo clara.
  • Un asistente de investigación con la búsqueda documental activada.
  • Un asistente de soporte con tono y estructura de respuesta fijos.

Las personas guardan el modelo seleccionado, el mensaje del sistema, los parámetros de generación, el avatar o fondo y ajustes opcionales de memoria y mutación. También pueden exportarse e importarse como JSON.

Conservar notas duraderas junto al trabajo​

Abre Notas desde el menú de creación cuando la información deba mantenerse independiente de un chat o una tarea de Work. Las notas admiten vista previa Markdown, edición explícita, búsqueda y guardado automático. La vista previa también representa SVG en línea y HTML básico incrustados en una nota, tras sanearlos para que nunca se ejecuten scripts, controladores de eventos ni URL peligrosas. El panel de herramientas de notas añade un historial de revisiones con restauración, archivos adjuntos, fijación, uso compartido por usuario (lectura o edición), exportación Markdown y una barra lateral de edición con IA que muestra cada propuesta como un diff antes de aplicarla. Como la aplicación captura primero la versión anterior, cualquier edición con IA puede deshacerse. Las notas pertenecen a la cuenta y se incluyen en el archivo completo del usuario; el historial de revisiones y los adjuntos permanecen en la instancia y no forman parte del archivo.

Hacer más fiables los artefactos​

Libre WebUI detecta etiquetas explícitas de artefactos, bloques de código cercados, documentos HTML independientes y paquetes HTML comunes con varios archivos. Para obtener el mejor artefacto de un modelo, pídele:

Create one complete self-contained HTML file.
Inline the CSS and JavaScript.
Do not rely on external files unless they are CDN URLs.

Si quieres bloques separados, ponles nombres claros:

```html filename="index.html"
...
```

```css filename="style.css"
...
```

```js filename="app.js"
...
```

Libre WebUI intentará integrar los bloques CSS y JavaScript locales en la vista previa HTML.

Poner prompts en cola mientras fluye una respuesta​

Enviar durante la generación añade el prompt a la cola en lugar de descartarlo: los prompts pendientes aparecen sobre el editor, pueden editarse, reordenarse y eliminarse, y se envían uno a uno al terminar cada respuesta. La cola se guarda con el chat, por lo que sobrevive a una recarga o reconexión.

Bifurcar una conversación​

El botón de bifurcación de cualquier mensaje copia la conversación hasta ese punto en un chat nuevo, incluidas las variantes, y registra su origen. La conversación original no cambia, por lo que las digresiones exploratorias no contaminan el hilo principal.

Comparar modelos en un turno​

El botón de columnas junto al selector de herramientas envía tu siguiente prompt a un máximo de tres modelos adicionales. Cada respuesta es una generación independiente con su propia etiqueta, estadísticas y control de cancelación, de modo que un modelo lento o fallido no bloquea a los demás.

Usar el chat con documentos de forma deliberada​

El chat con documentos acepta archivos PDF, Office (DOCX/PPTX/XLSX), Markdown, HTML, de código y CSV de hasta 10 MB. La búsqueda funciona de dos formas:

  • La búsqueda por palabras clave (BM25) siempre está disponible.
  • La búsqueda híbrida fusiona la clasificación semántica y por palabras clave cuando los embeddings están activados en Ajustes y hay un modelo de embeddings disponible.

Instala nomic-embed-text si quieres un modelo local de embeddings sencillo:

ollama pull nomic-embed-text

Para obtener mejores resultados, sube documentos enfocados por chat en lugar de un enorme conjunto heterogéneo.

Ajustar la configuración de generación​

AjusteUso práctico
TemperaturaBájala para mejorar la precisión y súbela para explorar creativamente
Top P / Top KConserva los valores predeterminados salvo que ajustes el muestreo a propósito
Ventana de contextoAuméntala en chats largos solo si el modelo y la memoria lo permiten
Máximo de tokensLimita respuestas largas o auméntalo para generar código y artefactos
Penalización por repeticiónSúbela ligeramente cuando un modelo entra en bucle

Cuando un modelo se comporte mal, baja primero la temperatura, reduce después la presión del contexto y prueba finalmente otro modelo.

Decidir cuánto razona un modelo​

El control situado junto al nombre del modelo en el editor abre los niveles de razonamiento: desactivado, activado, bajo, medio y alto. La selección pertenece a la conversación, así que sobrevive a una recarga y se aplica a la regeneración; Ajustes > Generación contiene el valor predeterminado de las respuestas nuevas, y el panel de controles del chat muestra el mismo valor.

Si lo dejas sin definir, no se envía nada, igual que en todas las versiones anteriores. Si lo defines, el servidor traduce el valor para el proveedor que responda: Ollama lo recibe en el cuerpo de la solicitud, los proveedores compatibles con OpenAI reciben un esfuerzo de razonamiento y Anthropic y Gemini reciben un presupuesto de tokens con espacio reservado para la respuesta. Claude Sonnet 5.5 y Opus 5.5 no usan presupuesto: razonan de forma adaptativa, un nivel con nombre se convierte en su ajuste de esfuerzo, y desactivado en Sonnet 5.5 mantiene desactivado el razonamiento inicial con el modo between_tools de Anthropic. Opus 5.5 no tiene interruptor de apagado, así que desactivado lo deja en su propio valor predeterminado.

Conviene saber dos cosas. Un modelo que Ollama declara incapaz de razonar nunca recibe el ajuste, así que el control simplemente no aparece. Además, los niveles con nombre solo existen en modelos que los publican, como gpt-oss; en un modelo que razona sin niveles, cualquier nivel con nombre se comporta como activado, de modo que cambiar de modelo dentro de un chat no produce errores. Cuando se define un valor predeterminado global o fijado, el botón del editor muestra el nivel con el que realmente se ejecutará la siguiente respuesta, y la entrada «Predeterminado» indica a qué valor se resuelve actualmente.

Vigilar la ventana de contexto​

El anillo junto al nombre del modelo se llena conforme crece la conversación. Pasa el cursor por encima para ver cuánto se ha llenado, los tokens usados y la ventana respecto a la cual se miden. Se vuelve ámbar al superar cuatro quintas partes y rojo al alcanzar el límite; si se desconoce la ventana de un modelo, muestra un anillo discontinuo en lugar de uno vacío.

El recuento cubre lo que enviará realmente la siguiente solicitud: el historial compactado y las ramas abandonadas no cuestan nada. Parte de la medición del proveedor para la última respuesta, si existe, y añade una estimación de cuatro caracteres por token para lo añadido desde entonces, marcada con ~ cuando aún no hay medición. Si una ventana está limitada por debajo de la longitud de entrenamiento del modelo, se indica: el medidor mide la ventana real de la solicitud, que es OLLAMA_MAX_CONTEXT (32,768 de forma predeterminada), no la longitud completa de entrenamiento. Aumenta esa variable y tanto la ventana real como el medidor cambiarán con ella.

Los modelos de proveedores solo muestran una ventana cuando su catálogo publica una. Si no, el medidor sigue contando tokens, pero no tiene ningún valor entre el que dividirlos.

Permitir que los chats largos se compacten solos​

Los administradores pueden activar la compactación del contexto en Ajustes > Generación. Cuando el contexto estimado de una conversación supera el umbral de tokens, el servidor pide a un modelo que resuma los mensajes antiguos y conserva literalmente solo los más recientes. El resumen aparece como una tarjeta en el punto donde se plegó el historial, y los mensajes resumidos se muestran atenuados: siguen siendo legibles, pero ya no se envían al modelo. Con la compactación activada, el número de «mensajes recientes conservados» también es la ventana móvil que envía una conversación, por lo que aumentarlo amplía realmente lo que ve el modelo.

AjusteQué controla
Umbral de tokensTamaño estimado del contexto que activa una compactación
Mensajes recientes conservadosCuántos de los mensajes más recientes permanecen siempre literales
Modelo de compactaciónModelo que escribe los resúmenes; de forma predeterminada, el de la conversación
Prompt de resumen personalizadoTus instrucciones, con {{PREVIOUS_SUMMARY}} y {{MESSAGES}}

La compactación está desactivada de forma predeterminada y se aplica a todos los usuarios del servidor, pero cada chat mantiene el control: su panel puede desactivarla para una conversación y cada tarjeta de resumen incluye una opción de deshacer, que reactiva exactamente los mensajes sustituidos por ese resumen, una compactación cada vez. Nunca divide un turno: los mensajes conservados literalmente siempre comienzan por uno tuyo. Cada nueva compactación integra el resumen anterior en el nuevo, por lo que una conversación mantiene un único resumen acumulativo. Si falla el resumidor, la generación continúa con el historial sin compactar en lugar de bloquearse.

Mantener claves de proveedores por usuario​

Los plugins de proveedores pueden leer claves del entorno, pero las credenciales por usuario suelen ser más adecuadas para instalaciones compartidas. Añade las claves en Ajustes para que cada usuario controle su propio acceso a los proveedores.

Usa variables de entorno del backend para valores predeterminados de todo el despliegue o instalaciones automatizadas.

Hacer predecible el acceso remoto​

Para acceder desde un teléfono o la red local, vincula el servidor de desarrollo a la interfaz de red:

npm run dev:host

Después abre la IP LAN o Tailscale de la máquina en el puerto 8080 desde el otro dispositivo (dev:host sirve el frontend en 8080, no en el puerto predeterminado de Vite). En producción, define explícitamente CORS_ORIGIN y la URL de la API del frontend para que los navegadores no recurran a localhost.

Consultar tu versión sin salir de la aplicación​

Ajustes → Acerca de compara tu compilación con la última versión de GitHub: indica cuándo está al día, enlaza la página de la versión cuando está atrasada y señala si una compilación -dev se adelanta a la versión fijada. La misma línea incluye un botón Ver registro de cambios que vuelve a abrir las notas de versión mostradas tras actualizar. Si Libre WebUI te resulta útil, el enlace Dar una estrella en GitHub es la forma más sencilla de ayudar a otras personas a encontrarlo.

Mantener sincronizadas la documentación y la interfaz​

El producto cambia rápidamente. Prefiere documentos duraderos que describan comportamientos y flujos de trabajo, y deja que la interfaz muestre las listas de modelos actuales de los proveedores. Evita copiar catálogos extensos de proveedores en la documentación salvo que la aplicación genere la lista.

Documentación relacionada​