LM-WebUI is the local-first control plane for AI workloads.
Run and operate models, inference runtimes, agents, tools, retrieval, and usage from one workspace across local and cloud environments.
Run Local AI, Without the Complexity
AI workloads are assembled from separate models, runtimes, agents, tools, retrieval systems, and provider dashboards. That makes execution difficult to configure, monitor, debug, and control.
LM-WebUI brings that execution layer together while preserving local-first deployment and hybrid cloud flexibility.
- Models and model providers
- Local inference runtimes
- Agent sessions and tools
- Multimodal retrieval and context
- Modality-aware execution routing
- Usage and token tracking
- Hardware-aware execution
- Generated artifacts and media
LM-WebUI combines runtime management, multimodal chat, retrieval, image generation, and agent workflows in one privacy-first workspace.
No more setup maze. LM-WebUI makes local AI inference easier to run and use. Install and manage inference runtimes, download models, and work with local AI instantly from one interface.
Powered by Smart-Modality™, an intent-routing system that automatically determines what each request needs, chat, files, RAG, web search, vision, or image generation. No manual model switching, no unnecessary processing, and reducing unnecessary context to achieve more efficient inference especially on low resource hardware. Make your local AI workflow multimodal without making it more complicated.
Run locally when you want, connect cloud APIs when you need, and keep control of your data.
Built open-source for developers, system integrators, and organizations that want easy local inference, reproducibility, and infrastructure-level control without the usual setup overhead.
Install LM-WebUI with one command:
curl -fsSL https://lmwebui.com/install.sh | bashThe installer sets up LM-WebUI as a system service and starts it automatically.
Open http://localhost:7070 in your browser.
Your models, data, and configuration are stored locally under ~/.lmwebui/. You can change the location with the LMWEBUI_HOME environment variable.
| Feature | Capabilities |
|---|---|
| Smart-Modality™ | Automatically chooses the right path for each request, direct chat, RAG, web search, vision, or image generation. So, simple tasks stay fast without unnecessary processing, retrieval runs only when you need past data, and web search combines with RAG/vision (or is skipped for direct image questions). |
| Runtime Manager | Manages the inference engines and model formats below — llama.cpp (GGUF), MLX, and ComfyUI (image workflows). Ollama and vLLM are configured as API providers in Settings. |
| Files & RAG | Upload documents, images, and audio for conversation context. Extract/OCR content, upload status, file references, and citation display. Retrieval via LatentFusion RAG that makes a single query finds relevant text chunks and visually-matching images and shared latent vector space, fused with Reciprocal Rank Fusion. |
| Multimodal Retrieval | Cross-modal search across docs, images, and audio in one latent index (SigLIP2 text + vision, CLAP-ready). A text query returns matching paragraphs and diagrams/charts in a single pass. |
| Multimodal Vision | Analyze images, screenshots, diagrams, and other visual content using compatible local vision models — auto-routed, no manual model switching. Simple image questions answer directly via the vision model; complex ones compose with RAG and web context. |
| Chat | Chat with local or cloud AI models from one interface. Supports GGUF/llama.cpp, MLX, Ollama, vLLM, OpenAI, Gemini, Anthropic, DeepSeek, Grok, and more. Includes streaming, code rendering, Mermaid diagrams, tables, conversations, and web search. |
| Image Generation | Dedicated Image Studio with prompt, size, quality, and seed controls. Gallery for browsing and reuse. Supports OpenAI, Google Gemini, and local ComfyUI runtimes. |
| Projects | Group related conversations with reusable custom system prompts. Ideal for recurring workflows like code review, research, or team-specific assistant configurations. |
| Agent Hub | Chat with host CLI agents — Claude Code, Codex, OpenCode, Hermes — in multi-turn, resumable sessions. Reopen any past session from the rail to continue it, run the CLI's real commands via the / menu, and manage each agent's config/skill/memory. Backed by the installed CLI, not a wrapper. |
| Voice & Video | Transcribe voice notes and audio (ASR → text into the retrieval index) and summarize linked YouTube videos — queried just like documents. |
| Hardware Detection | Automatic detection of CPU, CUDA, ROCm, and Apple Metal with dynamic memory and layer optimization for efficient local execution. |
| GGUF / llama.cpp | Built-in GGUF model lifecycle, download from HuggingFace, upload, validate, and serve models locally via the llama.cpp engine. Vision through llama-server. Background, single-flight download queue that survives closing the UI. |
| MLX | Inference on Apple Silicon via the MLX framework (mlx-lm). Model download from HuggingFace with one click. Seamless chat integration. |
| Artifacts | Persistent structured document storage with versioning, project and conversation association, and soft-delete support. |
| Usage Analytics | Token and request tracking per provider and model. Admin dashboard with usage summaries, per-user breakdowns, and CSV export. |
| Self-Hosted Ready | Native Python service, zero external telemetry, offline-capable. Data in ~/.lmwebui/. Docker deployment also available. |
- Apple Silicon Optimized: Native MLX inference (
mlx-lm) without an additional model server - One-Click Setup: Install and manage MLX from the Runtime Manager
- Model Management: Download, organize, or remove MLX models with one click
- HuggingFace Integration: Direct download support from HuggingFace MLX repositories
- Seamless Integration: Use MLX models directly in the chat interface
- Automatic Detection: Auto-detects Apple Silicon hardware and manages the MLX framework
- Model Management: Download, organize, or remove GGUF models with one click
- Vision Models: Image-text-to-text (VL) GGUF models that auto-pair with their
mmprojfile - HuggingFace Integration: Direct download from HuggingFace repositories with auto-resolved quantization options
- Hardware Awareness: Detects available hardware and helps you choose a compatible engine and model
- Seamless Integration: Use GGUF models directly in the chat interface
For detailed documentation, see the docs/ directory:
- Getting Started — Complete setup guide
- Features — Detailed feature documentation
- Architecture — Backend, frontend, provider, and runtime design
- Deployment — Production deployment guides
- CLI — Host CLI reference
- Contributing — How to contribute to the project
- Security — Security policy and practices
LM-WebUI is a React + FastAPI application, a modular monolith backend and a feature-based frontend, orchestrated by a Smart-Modality router that routes each request to the right capability.
See docs/architecture.md for the full directory structure, module breakdown, data flows, and design decisions.
For contributors and developers who want to run LM-WebUI from source:
git clone https://github.com/lm-webui/lm-webui.git
cd lm-webui
# Start backendcd backend
uv venv .venv &&source .venv/bin/activate && uv pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 7070
# In another terminal, start frontendcd web
npm install
npm run devThe development frontend runs on the configured Vite port and proxies API requests to the backend on port 7070.
The install.sh script sets up a systemd (Linux) or launchd (macOS) service running on port 7070.
curl -fsSL https://raw.githubusercontent.com/lm-webui/lm-webui/main/install.sh | bashData, models, and config live in ~/.lmwebui/ (override with LMWEBUI_HOME environment variable).
For containerized server deployments, Docker Compose is available in the repository:
git clone https://github.com/lm-webui/lm-webui.git
cd lm-webui
docker compose up --buildOpen http://localhost:7070.
| Data | Location |
|---|---|
| SQLite / application data | Docker volume → /backend/data |
| Generated media / uploads | Docker volume → /backend/media |
| Local models | ./.lmwebui/models → /backend/models |
| Secrets | ./.lmwebui/secrets → /backend/.secrets |
See Host CLI and Deployment for setup, runtime endpoints, and troubleshooting.
We welcome and appreciate all kinds of contributions!
Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add or update tests where appropriate
- Submit a pull request
Not ready to code? Bug reports, feature ideas, documentation improvements, and real-world testing are also valuable contributions. 🙏
This project is licensed under the MIT License — see the LICENSE file for details.
- Website: lmwebui.com
- GitHub: github.com/lm-webui/lm-webui
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Let's shape the future of local AI together 🤜🤛