Jan - Local AI Assistant (Jan is a ChatGPT-alternative that runs 100% offline on your device.)

Jan - Local AI Assistant (Jan is a ChatGPT-alternative that runs 100% offline on your device.)

Admin JobMatrixAI

Jan - Local AI Assistant

Jan banner

GitHub commit activity Github Last Commit Github Contributors GitHub closed issues Discord

Getting Started - Docs - Changelog - Bug reports - Discord

Jan is a ChatGPT-alternative that runs 100% offline on your device. Our goal is to make it easy for a layperson to download and run LLMs and use AI with full control and privacy .

⚠️ Jan is in active development.

Installation

Because clicking a button is still the easiest way to get started:

Platform Stable Beta Nightly
Windows jan.exe jan.exe jan.exe
macOS jan.dmg jan.dmg jan.dmg
Linux (deb) jan.deb jan.deb jan.deb
Linux (AppImage) jan.AppImage jan.AppImage jan.AppImage

Download from jan.ai or GitHub Releases .

Demo

Features

  • Local AI Models : Download and run LLMs (Llama, Gemma, Qwen, etc.) from HuggingFace
  • Cloud Integration : Connect to OpenAI, Anthropic, Mistral, Groq, 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 enhanced 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 ≥ 1.22.0
  • Make ≥ 3.81
  • Rust (for Tauri)

Quick Start

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

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

Alternative Commands

If you prefer the verbose approach:

# Setup and development
yarn install
yarn build:core
yarn build:extensions
yarn dev

# Production build
yarn build

# Clean slate (when things inevitably break)
make clean

Available Make Targets

  • make dev - Full development setup and launch (recommended)
  • make dev-tauri - Tauri development (deprecated, use make dev )
  • make build - Production build
  • make install-and-build - Install dependencies and build core/extensions
  • make test - Run tests and linting
  • make lint - Check your code doesn't offend the linters
  • make clean - Nuclear option: delete everything and start fresh

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

When things go sideways (they will):

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

We keep logs for 24 hours, so don't procrastinate on reporting issues.

Contributing

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

Contact

Trust & Safety

Friendly reminder : We're not trying to scam you.

  • We won't ask for personal information
  • Jan is completely free (no premium version exists)
  • We don't have a cryptocurrency or ICO
  • We're bootstrapped and not seeking your investment (yet)

License

Apache 2.0 - Because sharing is caring.

Acknowledgements

Built on the shoulders of giants: