jan README

The project's README from github.com/janhq/jan. As one markdown file: README.md.

Jan - Open-source ChatGPT replacement

github jan banner

English · 中文 · 日本語

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

Getting Started - Community - Changelog - Bug reports

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

Get it from Microsoft Store Get it on Flathub

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

Platform Download
Windows jan.exe
macOS jan.dmg
Linux (deb) jan.deb
Linux (AppImage) jan.AppImage
Linux (Arm64) How-to

Download from jan.ai or GitHub Releases.

Features

Build from Source

For those who enjoy the scenic route:

Prerequisites

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:

Manual Commands

yarn install
yarn build
yarn dev

Building on Windows

Run make dev from Git Bash (installed with Git for Windows) — make dispatches its recipes through sh, so a plain cmd.exe won't work.

You do not need a "Native Tools Command Prompt for VS 2022". The bundled llama.cpp engine builds with Ninja + clang-cl, and clang-cl locates the MSVC toolchain and Windows SDK on its own. What has to be installed (and on PATH for ninja/clang-cl/cmake):

Engine variants are picked with JAN_ENGINE_VARIANT (tokens: cpu, vulkan, metal, cuda12, cuda13, hip/rocm, joined by -), e.g.:

make dev JAN_ENGINE_VARIANT=cuda13

"nvcc fatal : Could not open output file ...fattn-...cu.obj.d" during tauri-plugin-llamacpp(build) means the build path crossed Windows' 260-character MAX_PATH limit — nvcc does not honor the long-path opt-in. The build script now detects this and automatically relocates the llama.cpp build tree to a short directory under %LOCALAPPDATA%\jan-engine. If you hit path-length errors anyway, set JAN_ENGINE_BUILD_DIR to a short path (e.g. C:\jb) or move the checkout closer to the drive root.

System Requirements

Minimum specs for a decent experience:

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.

Note: Please sign your commits so we can verify your contributions.

Contact

License

Apache 2.0 - Because sharing is caring.

Acknowledgements

Built on the shoulders of giants:

jan (janhq/jan)

Searching Database…

45K ·GitHub
Что это такое?Jan — это открытая альтернатива ChatGPT, которую можно развернуть на собственном компьютере. Она работает полностью офлайн и позволяет скачивать и запускать большие языковые модели (LLM) локально, сохраняя полный контроль над данными и приватность.
Это настольное приложение или программа, которую запускают в терминале?Это настольное приложение, созданное на Tauri (бэкенд на Rust). Есть установщики для Windows, macOS и Linux (deb, AppImage, Arm64).
Как его запустить?Скачайте готовый установщик для своей ОС с jan.ai или из GitHub Releases либо соберите приложение из исходников с помощью Node.js, Yarn, Make и Rust, выполнив 'make dev'.
С какими подводными камнями можно столкнуться при сборке под Windows?Команду 'make dev' нужно запускать из Git Bash, а не из cmd.exe, так как make передаёт рецепты через sh. Кроме того, длинные пути сборки могут упереться в ограничение Windows в 260 символов (MAXPATH); скрипт сборки пытается обойти его автоматически.
Какое железо нужно, чтобы крупные модели работали без тормозов?Минимальные требования зависят от размера модели: 8 ГБ оперативной памяти для моделей на 3B, 16 ГБ для 7B и 32 ГБ для 13B. Ускорение на GPU доступно в Windows (NVIDIA/AMD/Intel Arc) и Linux.
Мои данные уходят с компьютера?Нет — всё работает локально по умолчанию, а облачные подключения (OpenAI, Anthropic и др.) используются только если вы сами их явно настроили.
Может ли Jan подключаться и к облачным ИИ-провайдерам или он работает только локально?Может и то, и другое: он полностью офлайн запускает локальные модели, а также поддерживает облачную интеграцию для подключения GPT через OpenAI, Claude через Anthropic, Mistral, Groq и MiniMax.
Предоставляет ли Jan API, которым могут пользоваться другие приложения?Да, он запускает совместимый с OpenAI API на локальном сервере localhost:1337, чтобы другие приложения могли с ним взаимодействовать.
Умеет ли Jan делать что-то кроме чата, например использовать инструменты или агентов?Да, есть интеграция с Model Context Protocol (MCP) для агентных возможностей, а также можно создавать собственных ассистентов для специализированных задач.
Откуда берутся локальные модели?Вы скачиваете и запускаете LLM, например Llama, Gemma, Qwen и GPT-oss, напрямую с HuggingFace.
Creator
janhq
Size
1.5 GB
Stars
45K
Age
3y
Commits · 90 Days