Open Source & Self-Hosted

Libre WebUI

v0.12.1 What's new?
Release Notes View all →
✨ New Features
  • Introduced a new Libre WebUI wordmark logo featuring bold "Libre" and regular "WebUI" text in white on black, with updated favicons, logos, and the Electron application icon.
🔧 Improvements
  • Updated the project screenshot to reflect the current interface.
  • Refactored and improved the release changelog generation pipeline with new shared library modules and dedicated tests.
  • Removed obsolete local helper scripts, stale maintenance shell scripts, deprecated type stubs (@types/express-rate-limit and @types/uuid), and outdated documentation to clean up the repository.
🐛 Bug Fixes
  • Added explicit spacing between "Libre" and "WebUI" in the logo for better readability.
  • Refreshed verified provider plugin catalogs and provider models from verified sources across multiple providers, including Anthropic, Gemini, GitHub, Groq, Hugging Face, Mistral, OpenAI, and OpenRouter.

A polished self-hosted AI workspace for local Ollama models, cloud providers, Libre Claw agents, personas, documents, and interactive artifacts. Private by default. Built to stay yours.

npx libre-webui

Requires Node.js 18+ and Ollama for local AI

Built for Real AI Workflows

Chat, inspect, generate, and extend from one focused workspace

Libre Claw integration

Control local agents without giving up your workspace.

Start chat or goal-mode runs, approve tool calls, inspect event timelines, manage schedules, and keep the agent daemon local.

Approvals Automations Usage
01
Approvals

Start chat or goal-mode runs, approve tool calls, inspect event timelines, manage schedules, and keep the agent daemon local.

02
Automations

Start chat or goal-mode runs, approve tool calls, inspect event timelines, manage schedules, and keep the agent daemon local.

03
Usage

Start chat or goal-mode runs, approve tool calls, inspect event timelines, manage schedules, and keep the agent daemon local.

Interactive Artifacts

Chat beside the things your model builds.

Render HTML, SVG, and React components directly in chat. Live preview with full-screen mode.

Local & Cloud AI Document Chat (RAG) Plugin Variables
01
Local & Cloud AI

Run models locally with Ollama or connect to OpenAI, Anthropic, Groq, Gemini, Mistral, and more. Your choice.

02
Document Chat (RAG)

Upload PDFs, docs, and text files. Ask questions about your documents with semantic search and vector embeddings.

03
Plugin Variables

Per-plugin configurable settings like temperature, endpoints, and tokens. Sensitive values are encrypted at rest.

Local & Cloud AI

Run models locally with Ollama or connect to OpenAI, Anthropic, Groq, Gemini, Mistral, and more. Your choice.

Libre Claw Agents

Run durable local agents with approvals, tools, memory, automations, run timelines, and usage visibility from Libre WebUI.

Document Chat (RAG)

Upload PDFs, docs, and text files. Ask questions about your documents with semantic search and vector embeddings.

Interactive Artifacts

Render HTML, SVG, and React components directly in chat. Live preview with full-screen mode.

AES-256 Encryption

Enterprise-grade encryption for all your data. Chat history, documents, and settings are encrypted at rest.

Custom Personas

Create AI personalities with unique behaviors and system prompts. Import/export personas as JSON.

Text-to-Speech

Listen to AI responses with multiple voice options. Supports browser TTS and ElevenLabs integration.

Image Generation

Generate images with ComfyUI and Flux models. Multiple sizes, quality presets, and seamless chat integration.

Plugin Variables

Per-plugin configurable settings like temperature, endpoints, and tokens. Sensitive values are encrypted at rest.

Keyboard Shortcuts

VS Code-inspired shortcuts for power users. Navigate, toggle settings, and control everything from the keyboard.

Multi-User Support

Role-based access control with SSO support. GitHub and Hugging Face OAuth built-in.

Connect to Any Provider

One interface, unlimited possibilities

Ollama
Local models
OpenAI
OpenAI GPT models
Anthropic
Claude model catalog
Groq
Groq-hosted models
Google
Gemini model catalog
Mistral
Mistral model catalog
OpenRouter
Live model catalog
HuggingFace
HF Router catalog
Custom
Any OpenAI-compatible API

Get Started in Seconds

Choose your preferred installation method

Recommended

npx (One Command)

npx libre-webui

Runs instantly. No installation required.

npm (Global Install)

npm install -g libre-webui
libre-webui

Install once, run anywhere.

Docker

docker run -p 8080:8080 libre-webui/libre-webui

Containerized deployment.

Create Custom Plugins

Connect any OpenAI-compatible LLM with a simple JSON file

Available Plugins

Official plugins from the Libre WebUI repository. Click to view or download.

Loading plugins from GitHub...
custom-model.json
{
  "id": "custom-model",
  "name": "Custom Model",
  "type": "completion",
  "endpoint": "http://localhost:8000/v1/chat/completions",
  "auth": {
    "header": "Authorization",
    "prefix": "Bearer ",
    "key_env": "CUSTOM_MODEL_API_KEY"
  },
  "model_map": [
    "my-fine-tuned-llama"
  ],
  "variables": [
    {
      "name": "temperature",
      "type": "number",
      "label": "Temperature",
      "default": 0.7,
      "min": 0, "max": 2
    }
  ]
}

Create Your Own Plugin

1

Start Your LLM Server

Run any OpenAI-compatible server: llama.cpp, vLLM, Ollama, or a custom FastAPI server.

2

Create Plugin JSON

Define your endpoint, authentication, and available models in a simple JSON file.

3

Upload to Libre WebUI

Go to Settings > Providers, upload your plugin, and enter your API key.

4

Start Chatting

Your custom models appear in the model selector. Full privacy, full control.

Plugin Fields Reference

id Unique identifier (lowercase, hyphens allowed)
name Display name shown in the UI
type "completion" for chat, "tts" for text-to-speech
endpoint API URL (e.g., /v1/chat/completions)
auth.header Auth header name (Authorization, x-api-key)
auth.prefix Key prefix ("Bearer " or empty)
auth.key_env Environment variable for your API key
model_map Array of available model identifiers
variables Configurable settings (temperature, endpoint, etc.)

Ready to Own Your AI?

Join thousands of users who value privacy and control.