explaingit

janhq/jan

Analysis updated 2026-06-20

42,408TypeScriptAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

Jan is a desktop app that runs AI chat models entirely on your own computer with no internet, giving you a private, offline ChatGPT-style experience with full control over your data.

Mindmap

mindmap
  root((jan))
    What it does
      Local AI chat
      Offline model runner
      OpenAI-compatible API
    Features
      HuggingFace models
      MCP tool support
      Cloud API fallback
    Use Cases
      Private AI assistant
      Dev API testing
      Open-source experiments
    Tech Stack
      TypeScript
      Tauri
      llama.cpp
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Download and chat with open-source AI models locally with no subscription or data leaving your machine.

USE CASE 2

Run a local OpenAI-compatible API server so you can test your AI app against local models before paying for cloud API calls.

USE CASE 3

Use Jan's MCP support to let your local AI browse the web, read files, or call tools during a conversation.

What is it built with?

TypeScriptTauriRustllama.cpp

How does it compare?

janhq/jancalcom/cal.diypayloadcms/payload
Stars42,40842,37342,223
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audiencevibe codervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Download the desktop app and then download a model, model download can take 5-30 minutes depending on size.

In plain English

Jan is an open-source desktop application that lets you download and run large language models, the kind of AI that powers ChatGPT, entirely on your own computer, with no internet connection required once the models are downloaded. The problem it solves is privacy and control: services like ChatGPT send your conversations to external servers, whereas Jan keeps everything local so your data never leaves your machine. With Jan, you browse and download models from HuggingFace, a platform that hosts open-source AI models. Once downloaded, models run locally using your computer's CPU or GPU. You can then chat with them through a user-friendly interface similar to ChatGPT. Jan also supports connecting to cloud AI providers like OpenAI, Anthropic Claude, Mistral, and Groq if you prefer to use remote models for tasks requiring more power than your local hardware can provide. Beyond basic chat, Jan runs a local OpenAI-compatible API server on your machine at localhost:1337, which means other applications can send requests to it as if it were the real OpenAI API. This enables developers to build or test AI-powered apps against locally running models before using the paid cloud API. Jan also supports the Model Context Protocol (MCP), which allows the AI to take actions, browsing the web, reading files, or calling tools, rather than only generating text. Someone would use Jan when they want a private, offline AI assistant, when they are developing AI applications and want to cut costs during testing, or when they simply want to experiment with open-source models without a subscription. It runs on Windows, macOS, and Linux. The tech stack is TypeScript for the application frontend, Tauri (a Rust-based framework) for the native desktop shell, and llama.cpp under the hood for running the actual AI models.

Copy-paste prompts

Prompt 1
I've installed Jan, help me download a good all-round model for coding help that will run on a 16GB MacBook.
Prompt 2
Show me how to point my Python app's OpenAI client at Jan's local API on localhost:1337 so I can test without spending API credits.
Prompt 3
Using Jan with MCP, set up a workflow where the AI can read files from my project folder and answer questions about them.
Prompt 4
How do I add my Anthropic API key to Jan so I can switch between local models and Claude depending on the task?
Prompt 5
What models in Jan's library are best for coding tasks on a machine with an NVIDIA GPU?

Frequently asked questions

What is jan?

Jan is a desktop app that runs AI chat models entirely on your own computer with no internet, giving you a private, offline ChatGPT-style experience with full control over your data.

What language is jan written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, Rust.

How hard is jan to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is jan for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub janhq on gitmyhub

Verify against the repo before relying on details.