Jan - Local AI Assistant Getting Started - Docs - Changelog - Bug reports - Discord Jan is an AI assistant that can run 100% offline on your device. Download and run LLMs with full control and privacy. Installation 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, etc.) from HuggingFace : Download and run LLMs (Llama, Gemma, Qwen, etc.) from HuggingFace Cloud Integration : Connect to OpenAI, Anthropic, Mistral, Groq, and others : Connect to OpenAI, Anthropic, Mistral, Groq, and others Custom Assistants : Create specialized AI assistants for your tasks : Create specialized AI assistants for your tasks OpenAI-Compatible API : Local server at localhost:1337 for other applications : Local server at for other applications Model Context Protocol : MCP integration for enhanced capabilities : 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) Run with Make git clone https://github.com/menloresearch/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 - Full development setup and launch make build - Production build - Production build make test - Run tests and linting - Run tests and linting make clean - Delete everything and start fresh Run with Mise (easier) You can also run with mise, which is a bit easier as it ensures Node.js, Rust, and other dependency versions are automatically managed: git clone https://github.com/menloresearch/jan cd jan # Install mise (if not already installed) curl https://mise.run | sh # Install tools and start development mise install # installs Node.js, Rust, and other tools mise dev # runs the full development setup Available mise commands: mise dev - Full development setup and launch - Full development setup and launch mise build - Production build - Production build mise test - Run tests and linting - Run tests and linting mise clean - Delete everything and start fresh - Delete everything and start fresh mise tasks - List all available tasks Manual Commands yarn install yarn build:core yarn build:extensions yarn dev System Requirements Minimum specs for a decent experience: macOS : 13.6+ (8GB RAM for 3B models, 16GB for 7B, 32GB for 13B) : 13.6+ (8GB RAM for 3B models, 16GB for 7B, 32GB for 13B) Windows : 10+ with GPU support for NVIDIA/AMD/Intel Arc : 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: Check our troubleshooting docs Copy your error logs and system specs Ask for help in our Discord #🆘|jan-help channel Contributing Contributions welcome. See CONTRIBUTING.md for the full spiel. 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 License Apache 2.0 - Because sharing is caring. Acknowledgements Built on the shoulders of giants: