Documentation
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

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

  • MacOSX 13.6 or higher.

Installing Jan

To install Jan, follow the steps below:

Step 1: Download the Jan Application

Jan provides two types of releases:

Stable Releases

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

Make sure to verify the URL to ensure that it's the official Jan website and GitHub repository.

Step 2: Install the Jan Application

  1. Once you have downloaded the Jan app .dmg file, open the file.
  2. Drag the application icon to the Applications folder shortcut.
  3. Wait for the installation process.
  4. Once installed, you can access Jan on your machine.

Install Jan with Homebrew

You can also install Jan using the following Homebrew command:


brew install --cask jan

⚠️
  • Ensure that you have installed Homebrew and its dependencies.
  • Homebrew package installation is currently limited to Apple Silicon Macs, with upcoming support for Windows and Linux.

Data Folder

By default, Jan is installed in the following directory:


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

  • Please see the Jan Data Folder for more details about the data folder structure.

Metal Acceleration

Jan is specially designed to work well on Mac Silicon, using llama.cpp as its main engine for processing AI tasks efficiently. It automatically uses Metal (opens in a new tab), Apple's latest technology that can be used for GPU acceleration, so you don’t need to turn on this feature manually.

💡 Metal, used for GPU acceleration, is not supported on Intel-based Mac devices.

Uninstalling Jan

To uninstall Jan, follow the steps below:

  1. If the app is currently open, exit the app before continuing.
  2. Open the Finder menu.
  3. Click the Applications option from the sidebar.
  4. Find the Jan app or type in the search bar.
  5. Use any of these ways to move the Jan app to the Trash:
  • Drag the app to the Trash.
  • Select the app and choose the Move to Trash option.
  • Select the app and press Command-Delete on your keyboard.
  1. Use the following command to delete Jan's user data and app cache:

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