Documentation
Installation
Mac

Mac Installation

Jan has been developed as a Mac Universal application, allowing it to run natively on both Apple Silicon and Intel-based Macs.

Compatibility

Minimum Requirements

Ensure that your system meets the following requirements to use Jan effectively:

  • Operating System: MacOSX 13.6 or higher
  • Memory:
    • 8GB → up to 3B parameter models
    • 16GB → up to 7B parameter models
    • 32GB → up to 13B parameter models
  • Storage: 10GB+ free space

Mac Performance Guide

Apple Silicon Macs leverage Metal for GPU acceleration, providing faster performance than Appple Intel Macs, which rely solely on CPU processing.

Apple Silicon (M1, M2, M3)

  • Metal acceleration enabled by default, no configuration required
  • Optimized GPU-accelerated performance

Intel-based Mac

  • CPU-only processing
  • Uses regular processor, works slower

To verify your Mac's processor architecture: Apple menu  → About This Mac.

Install Jan

To install Jan, follow the steps below:

Step 1: Download Application

Jan provides 3 types of releases:

Please download Jan from official distributions, or build it from source.

Step 2: Install Application

  1. Download and open the Jan installer (.dmg file)
  2. Drag the Jan icon to your Applications folder
  3. Installation will take a few moments to complete
  4. Launch Jan from your Applications folder

Jan Data Folder

By default, Jan is installed in the following directory:


# Default installation directory
~/Library/Application\ Support/Jan/data

See Jan Data Folder for more details about the data folder structure.

Uninstall Jan

Step 1: Remove Application

  1. If Jan is currently open, exit the app
  2. Open Finder menu.
  3. Navigate to Applications
  4. Locate Jan (or use the search bar)
  5. Remove the application using any method:
  • Drag to Trash
  • Right-click → Move to Trash
  • Select and press Command-Delete

Step 2: Clean Up Data (Optional)

Open Terminal and run these commands to remove all Jan-related data:


# Remove all user data
rm -rf ~/jan
# Delete application data
rm -rf ~/Library/Application\ Support/Jan/data
# Delete application cache
rm -rf ~/Library/Application\ Support/Jan/cache

⚠️

Deleted data folders cannot be restored. Make sure to backup any important data before proceeding with deletion.

InstallationWindows