Welcome to Libre WebUI

Welcome to Libre WebUI

We’re excited to introduce Libre WebUI - a comprehensive, privacy-first interface for AI models that combines complete local control with flexible external service integration when you need it.

What Makes Libre WebUI Special?

Complete Ollama Integration

Libre WebUI provides the most comprehensive Ollama integration available, supporting every API endpoint including chat completion, model management, embeddings, blob handling, and advanced features like structured outputs and tool calling. Whether you’re managing models, generating embeddings, or building complex AI workflows, everything is integrated seamlessly.

Privacy by Design

Your data stays on your hardware by default. Unlike cloud-based AI services, Libre WebUI processes everything locally through Ollama, ensuring complete privacy and control. No telemetry, no tracking, no data collection - just pure, private AI interactions.

Revolutionary Plugin Architecture

While privacy is our core principle, we understand you sometimes need flexibility. Our innovative plugin system allows you to connect external AI services (OpenAI, Anthropic, Groq, or custom APIs) while maintaining local Ollama as your primary, private foundation. External services are optional enhancements, not dependencies.

Production-Ready Features

Built with modern web technologies including TypeScript, React, and comprehensive error handling. Features include:

  • VS Code-inspired keyboard shortcuts (⌘B, ⌘D, ⌘,, ?)
  • Code splitting and lazy loading for optimal performance
  • Real-time streaming responses with WebSocket integration
  • Comprehensive model management with pull, delete, and monitoring
  • Demo mode for trying the interface without installation
  • Responsive design that works perfectly on desktop, tablet, and mobile

Quick Setup

Getting started with Libre WebUI is incredibly simple:

One-Command Installation

1# Clone and auto-setup
2git clone https://github.com/libre-webui/libre-webui.git
3cd libre-webui
4./start.sh

Manual Setup

1# Install dependencies (uses npm workspaces)
2npm install
3
4# Start development servers
5npm run dev
6
7# Or with network access for mobile testing
8npm run dev:host

Optional Plugin Configuration

Connect external AI services by adding API keys to your environment:

1# Add to backend/.env
2OPENAI_API_KEY=your_openai_key
3ANTHROPIC_API_KEY=your_anthropic_key
4GROQ_API_KEY=your_groq_key

Access your private AI interface at http://localhost:5173

Core Features

🎯 Complete Model Management

  • Pull models from Ollama library with real-time progress tracking
  • Delete unused models to free storage space
  • View model details including capabilities and memory usage
  • Monitor running models and system resources
  • Create custom models and configurations

🚀 Advanced AI Capabilities

  • Multimodal support for vision models (image upload with drag-and-drop)
  • Structured outputs with JSON schema validation
  • Tool calling for enhanced AI capabilities
  • Embeddings generation for semantic search applications
  • Streaming responses with real-time generation

🔌 Flexible Plugin System

  • OpenAI integration - GPT-4, GPT-3.5 Turbo models
  • Anthropic Claude - Claude 3 Opus, Sonnet, Haiku
  • Groq support - High-speed Llama 3, Mixtral models
  • Custom APIs - Connect any OpenAI-compatible endpoint
  • Smart fallback - Automatically falls back to Ollama when external services fail
  • Plugin management - Upload, activate, deactivate through the UI

🛡️ Security & Privacy

  • Local-first architecture - Your data never leaves your device by default
  • Apache 2.0 licensed - Fully open source and transparent
  • No telemetry - Zero tracking or data collection
  • Rate limiting - Built-in protection against abuse
  • Path validation - Security measures against file system attacks
  • Input sanitization - Comprehensive security validation

Development & Community

Built for Developers

Libre WebUI is designed with developers in mind:

  • Modern tech stack - TypeScript, React, Node.js, Express
  • Comprehensive API - RESTful endpoints and WebSocket support
  • Code splitting - Optimized bundle sizes with lazy loading
  • Type safety - Full TypeScript coverage throughout
  • Clean architecture - Modular design with clear separation of concerns
  • Extensive documentation - Complete guides and API references

Active Development Scripts

 1# Development with auto-reload
 2npm run dev
 3
 4# Network-accessible development (mobile testing)
 5npm run dev:host
 6
 7# Production build
 8npm run build
 9
10# Code formatting and linting
11npm run format
12npm run lint
13
14# Clean dependency reinstall
15./clean-install.sh

Contributing Welcome

We actively welcome contributions from developers of all skill levels:

  • Frontend development - React components, UI/UX improvements
  • Backend architecture - API development, security enhancements
  • Documentation - Guides, tutorials, API documentation
  • Plugin development - External service integrations
  • Testing & QA - Bug reports, feature testing
  • Design - UI/UX design, accessibility improvements
  • Security - Code review, vulnerability assessment
  • Translations - Multi-language support

Join our vibrant community where privacy-conscious developers are building the future of AI interfaces.

What’s Next?

Libre WebUI continues to evolve rapidly with exciting features in development:

Upcoming Features

  • Enhanced plugin architecture - Even more flexible external service integration
  • Advanced model fine-tuning - Local model customization capabilities
  • Collaborative features - Team workspaces and shared sessions
  • Extended multimodal support - Audio and video processing
  • Advanced security controls - Enterprise-grade access management
  • Performance optimizations - Faster loading and response times
  • Mobile app - Native iOS and Android applications
  • API improvements - Enhanced developer experience

Community Growth

Our community is rapidly expanding with developers, researchers, and privacy advocates who believe in local-first AI. Recent milestones include:

  • Comprehensive security audit - CodeQL scanning and vulnerability fixes
  • Plugin ecosystem - Growing library of community-developed plugins
  • Documentation expansion - Complete guides for all skill levels
  • Performance improvements - Code splitting and optimization
  • Demo mode - Try Libre WebUI without any installation

Join the Privacy Revolution

Libre WebUI represents a fundamental shift toward user-controlled AI. By choosing local-first architecture with optional external enhancement, we’re proving that you don’t have to sacrifice privacy for functionality.

Whether you’re a developer building AI applications, a researcher working with sensitive data, or simply someone who values digital privacy, Libre WebUI provides the tools you need for powerful, private AI interactions.

Get Started Today

Ready to take control of your AI interactions? Here’s how to begin:

  1. Try the demo - Experience Libre WebUI without installation at our demo site
  2. Follow the setup guide - Complete installation instructions for your system
  3. Join the community - Connect with other privacy-focused developers
  4. Contribute - Help build the future of private AI interfaces

Experience the future of privacy-first AI. Get started with Libre WebUI and join thousands of users who’ve taken control of their AI interactions.