Jan vs Open WebUI

Jan - Open-source ChatGPT replacement

English · 中文 · 日本語

Getting Started - Community - Changelog - Bug reports

Jan is bringing the best of open-source AI in an easy-to-use product. Download and run LLMs with full control and privacy.

Installation

  <td align="center" valign="middle">
    <a href="https://apps.microsoft.com/detail/xpdcnfn5cpzlqb">
      <img height="60"
        width="200"
           alt="Get it from Microsoft Store"
           src="https://get.microsoft.com/images/en-us%20dark.svg"/>
    </a>
  </td>

  <td width="20"></td>

  <td align="center" valign="middle">
    <a href="https://flathub.org/apps/ai.jan.Jan">
      <img height="60"
        width="200"
           alt="Get it on Flathub"
           src="https://flathub.org/assets/badges/flathub-badge-en.svg"/>
    </a>
  </td>
</tr>

The easiest way to get started is by downloading one of the following versions for your respective operating system:

Download from jan.ai or GitHub Releases.

Features

• Local AI Models: Download and run LLMs (Llama, Gemma, Qwen, GPT-oss etc.) from HuggingFace
• Cloud Integration: Connect to GPT models via OpenAI, Claude models via Anthropic, Mistral, Groq, MiniMax, and others
• Custom Assistants: Create specialized AI assistants for your tasks
• OpenAI-Compatible API: Local server at localhost:1337 for other applications
• Model Context Protocol: MCP integration for agentic capabilities
• Privacy First: Everything runs locally when you want it to

Build from Source

For those who enjoy the scenic route:

Prerequisites

• Node.js ≥ 20.0.0
• Yarn ≥ 4.5.3
• Make ≥ 3.81
• Rust (for Tauri)
• (macOS Apple Silicon only) MetalToolchain xcodebuild -downloadComponent MetalToolchain

Run with Make

git clone https://github.com/janhq/jan
cd jan
make dev

This handles everything: installs dependencies, builds core components, and launches the app.

Available make targets:

• make dev - Full development setup and launch
• make build - Production build
• make test - Run tests and linting
• make clean - Delete everything and start fresh

Manual Commands

yarn install
yarn build
yarn dev

Building on Windows

Run make dev from Git Bash (installed with Git for Windows) — make dispatches its recipes through sh, so a plain cmd.exe won't work.

You do not need a "Native Tools Command Prompt for VS 2022". The bundled llama.cpp engine builds with Ninja + clang-cl, and clang-cl locates the MSVC toolchain and Windows SDK on its own. What has to be installed (and on PATH for ninja/clang-cl/cmake):

• Visual Studio 2022 Build Tools (MSVC x64 workload + Windows SDK)
• LLVM (provides clang-cl)
• Ninja
• CMake
• CUDA Toolkit — only for JAN_ENGINE_VARIANT=cuda12/cuda13 builds

Engine variants are picked with JAN_ENGINE_VARIANT (tokens: cpu, vulkan, metal, cuda12, cuda13, hip/rocm, joined by -), e.g.:

make dev JAN_ENGINE_VARIANT=cuda13

"nvcc fatal : Could not open output file ...fattn-...cu.obj.d" during tauri-plugin-llamacpp(build) means the build path crossed Windows' 260-character MAX_PATH limit — nvcc does not honor the long-path opt-in. The build script now detects this and automatically relocates the llama.cpp build tree to a short directory under %LOCALAPPDATA%\jan-engine. If you hit path-length errors anyway, set JAN_ENGINE_BUILD_DIR to a short path (e.g. C:\jb) or move the checkout closer to the drive root.

System Requirements

Minimum specs for a decent experience:

• macOS: 13.6+ (8GB RAM for 3B models, 16GB for 7B, 32GB for 13B)
• Windows: 10+ with GPU support for NVIDIA/AMD/Intel Arc
• Linux: Most distributions work, GPU acceleration available

For detailed compatibility, check our installation guides.

Troubleshooting

If things go sideways:

1. Check our troubleshooting docs
2. Copy your error logs and system specs
3. Ask for help in our Discord #🆘|jan-help channel

Contributing

Contributions welcome. See CONTRIBUTING.md for the full spiel.

Note: Please sign your commits so we can verify your contributions.

Links

• Documentation - The manual you should read
• API Reference - For the technically inclined
• Changelog - What we broke and fixed
• Discord - Where the community lives

Contact

• Bugs: GitHub Issues
• Business: hello@jan.ai
• Jobs: hr@jan.ai
• General Discussion: Discord

License

Apache 2.0 - Because sharing is caring.

Acknowledgements

Built on the shoulders of giants:

• Llama.cpp
• Tauri
• Scalar

Open WebUI

Open WebUI is a home for AI: an extensible, easy-to-use, self-hosted platform built to run entirely offline. Connect local models through Ollama or use OpenAI-compatible APIs for local and cloud models.

English |
简体中文 |
繁體中文 |
한국어 |
Deutsch |
Español |
Français |
Italiano |
Dansk |
日本語 |
Polski |
Русский |
Bosanski |
العربية |
Norsk |
Português (Brasil) |
ไทย |
Türkçe |
Українська |
বাংলা |
Ελληνικά |
Tiếng Việt

Explore Open WebUI →

Installation

Python

## With uv installed (macOS/Linux)
DATA_DIR=~/.open-webui uvx --python 3.12 open-webui@latest serve

## Or install and run with pip (Python 3.12)
pip install open-webui
open-webui serve

Then open http://localhost:8080.

Docker

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Then open http://localhost:3000.

Add these options to docker run before the image name as needed:

See the Docker installation guide for setup instructions and configuration options.

Desktop App

Download the native desktop app for macOS, Windows, and Linux.

Read the docs →

Ecosystem

• Open Terminal / Terminals (Enterprise): The action layer that turns Open WebUI into a full agent harness, with enterprise orchestration for per-user workspaces.
• Knowledge Base Sync (oikb): Mirror folders, repos, buckets, and wikis into Open WebUI Knowledge Bases with incremental sync.
• Open WebUI Computer: Your computer in any browser: files, editor, terminal, git, and optional AI agents, running on your real machine.

See the ecosystem documentation for details.

Troubleshooting and Updates

See the troubleshooting guide for connection issues and the updating guide to update your installation.

Documentation

See the docs for configuration and usage, and the roadmap for planned work.

For Docker Compose, Kubernetes, and other setups, see the installation docs.

Support

Open an issue or start a discussion.

Find us on Reddit, X, and Discord.

Security

Report vulnerabilities privately through GitHub security advisories. Security reports are accepted only through GitHub.

Star History

License

Includes code under the Open WebUI License, which requires preserving the Open WebUI branding, and prior contributions under their original licenses. See LICENSE and LICENSE_HISTORY for terms and history.

Enterprise · Careers · Sponsor

Created by Timothy Jaeryang Baek.