janhq

    janhq/jan

    #383 this week

    Jan is an open source alternative to ChatGPT that runs 100% offline on your computer.

    ai
    llm
    self-hosted
    chatgpt
    gpt
    llamacpp
    localai
    open-source
    TypeScript
    NOASSERTION
    42.3K stars
    2.8K forks
    42.3K GitHub watchers
    Updated 5/4/2026
    View on GitHub

    Backblaze Generative Media Hackathon

    Build the next generation of AI media apps with Genblaze, stored on Backblaze B2. $10,000 in prizes.

    Enter the hackathon

    Loading star history...

    Use Cases & Benefits

    • Jan is an open-source, offline ChatGPT alternative enabling local execution of large language models for privacy-focused AI interactions.
    • Key features include local AI model support, cloud integration with multiple providers, custom assistants, and an OpenAI-compatible local API server.
    • Strengths are privacy, full local control, and broad OS support; limitations include hardware requirements for larger models and dependency on local resources.
    • Organizations can deploy Jan for secure, private AI services without cloud dependency, ideal for sensitive data environments and custom AI workflows.
    • Ideal use cases include offline AI chatbots, private data processing, custom assistant creation, and development environments requiring local LLM access.

    About jan

    Jan - Open-source ChatGPT replacement

    github jan banner

    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

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

    PlatformDownload
    Windowsjan.exe
    macOSjan.dmg
    Linux (deb)jan.deb
    Linux (AppImage)jan.AppImage

    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, 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 ≥ 1.22.0
    • Make ≥ 3.81
    • Rust (for Tauri)

    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:tauri:plugin:api
    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)
    • 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.

    Contact

    License

    Apache 2.0 - Because sharing is caring.

    Acknowledgements

    Built on the shoulders of giants:

    Discover Repositories

    Search across tracked repositories by name or description