Repository: janhq/jan

Stars: 41819

README.md Copy Chapter

Jan - Open-source ChatGPT replacement

<img width="2048" height="280" alt="github jan banner" src="https://github.com/user-attachments/assets/f3f87889-c133-433b-b250-236218150d3f" />

<p align="center">
<strong>English</strong> ·
<a href="README.zh.md">中文</a>
</p>

<p align="center">
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/janhq/jan"/>
<img alt="Github Last Commit" src="https://img.shields.io/github/last-commit/janhq/jan"/>
<img alt="Github Contributors" src="https://img.shields.io/github/contributors/janhq/jan"/>
<img alt="GitHub closed issues" src="https://img.shields.io/github/issues-closed/janhq/jan"/>
<img alt="Discord" src="https://img.shields.io/discord/1107178041848909847?label=discord"/>
</p>

<p align="center">
<a href="https://jan.ai/docs/desktop">Getting Started</a>
- <a href="https://discord.gg/Exe46xPMbK">Community</a>
- <a href="https://jan.ai/changelog">Changelog</a>
- <a href="https://github.com/janhq/jan/issues">Bug reports</a>
</p>

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 Copy Chapter

<p align="center">
<table>
<tr>
<!-- Microsoft Store Badge -->
<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>
<!-- Spacer -->
<td width="20"></td>
<!-- Flathub Official Badge -->
<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>
</table>
</p>

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

<table>
<tr>
<td><b>Platform</b></td>
<td><b>Download</b></td>
</tr>
<tr>
<td><b>Windows</b></td>
<td><a href='https://app.jan.ai/download/latest/win-x64'>jan.exe</a></td>
</tr>
<tr>
<td><b>macOS</b></td>
<td><a href='https://app.jan.ai/download/latest/mac-universal'>jan.dmg</a></td>
</tr>
<tr>
<td><b>Linux (deb)</b></td>
<td><a href='https://app.jan.ai/download/latest/linux-amd64-deb'>jan.deb</a></td>
</tr>
<tr>
<td><b>Linux (AppImage)</b></td>
<td><a href='https://app.jan.ai/download/latest/linux-amd64-appimage'>jan.AppImage</a></td>
</tr>
<tr>
<td><b>Linux (Arm64)</b></td>
<td><a href='https://github.com/janhq/jan/issues/4543#issuecomment-4142429792'>How-to</a></td>
</tr>
</table>

Download from jan.ai or GitHub Releases.

Features Copy Chapter

- 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 Copy Chapter

For those who enjoy the scenic route:

Prerequisites Copy Section

- 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 Copy Section

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 Copy Section

yarn install
yarn build
yarn dev

System Requirements Copy Chapter

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 Copy Chapter

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 Copy Chapter

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

Links Copy Chapter

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

Contact Copy Chapter

- Bugs: GitHub Issues
- Business: [email protected]
- Jobs: [email protected]
- General Discussion: Discord

License Copy Chapter

Apache 2.0 - Because sharing is caring.

Acknowledgements Copy Chapter

Built on the shoulders of giants:

- Llama.cpp
- Tauri
- Scalar