MCPHub Lab
MCPHub LabRegistryjanhq/jan
janhq

janhq/jan

Built by janhq • 41,286 stars

Visit Repository

What is janhq/jan?

Jan is a desktop application that lets you run AI chatbots (like ChatGPT alternatives) completely on your own computer without sending your conversations to external companies. Think of it like having your own private ChatGPT that works offline.

How to use janhq/jan?

Download the application from jan.ai for your operating system (Windows, Mac, or Linux), install it like any other program, then download AI models to chat with locally on your computer.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/janhq-jan --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/janhq-jan

Key Features

Run AI models completely offline on your computer
Connect to cloud AI services if desired
Create custom AI assistants for specific tasks
Compatible with other applications through a local server
Privacy-focused - keeps your data on your device

Optimized Use Cases

Having private AI conversations without data leaving your computer
Running AI assistants for work tasks while keeping sensitive information local
Experimenting with different AI models offline
Creating specialized AI helpers for specific projects

janhq/jan FAQ

Q

Is this really private and offline?

Yes, when using local AI models, everything runs on your computer and no data is sent to external servers. You can also optionally connect to cloud services if you choose.

Q

Do I need a powerful computer to run this?

It depends on the AI model size you want to use. Smaller models (3B parameters) work with 8GB RAM, while larger, more capable models need 16-32GB RAM for good performance.

Official Documentation

View on GitHub

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"> <!-- 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

<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

  • 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

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.

Links

Contact

License

Apache 2.0 - Because sharing is caring.

Acknowledgements

Built on the shoulders of giants:

Global Ranking

8.5
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "janhq-jan": { "command": "npx", "args": ["janhq-jan"] } } }