From d0c21ee506f15da163556bae9bc2a23b45a3dab5 Mon Sep 17 00:00:00 2001 From: Ashley Date: Sun, 29 Dec 2024 22:58:22 +0700 Subject: [PATCH] [WIP] Updating docs... --- docs/src/pages/docs/desktop/mac.mdx | 116 +++++++++++------------- docs/src/pages/docs/desktop/windows.mdx | 93 +++++++++---------- 2 files changed, 96 insertions(+), 113 deletions(-) diff --git a/docs/src/pages/docs/desktop/mac.mdx b/docs/src/pages/docs/desktop/mac.mdx index 0e4dbd233..456c775ec 100644 --- a/docs/src/pages/docs/desktop/mac.mdx +++ b/docs/src/pages/docs/desktop/mac.mdx @@ -29,70 +29,73 @@ import FAQBox from '@/components/FaqBox' 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 for running up to 3B models - - 16GB for running up to 7B models - - 32GB for running up to 13B models - -Apple Silicon Macs leverage Metal for GPU acceleration, providing faster performance than Intel Macs, which rely solely on CPU processing. - -- **Disk:** At least 10GB for app and model download - - -- **Operating System:** MacOSX 13.6 or higher -- **Memory:** - - 8GB for running up to 3B models - - 16GB for running up to 7B models - - 32GB for running up to 13B models -- **Disk:** At least 10GB for app and model download - - + - 8GB → up to 3B parameter models + - 16GB → up to 7B parameter models + - 32GB → up to 13B parameter models +- **Storage:** 10GB+ free space -## Installing Jan +### 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 Jan Application - +### Step 1: Download Application Jan provides 3 types of releases: -#### Stable Releases - Please download Jan from official distributions, or build it from source. -- **Official Website**: [https://jan.ai](https://jan.ai/) -- **Jan GitHub repository**: [Github](https://github.com/janhq/jan/releases) +- [Download Jan's Stable Version](https://app.jan.ai/download/latest/mac-universal) +- Official Website: https://jan.ai/download + + + + +Beta releases let you test new features, which may be buggy: + +[Download Jan's Beta Version](https://app.jan.ai/download/beta/mac-universal) -Make sure to verify the URL to ensure that it's the official Jan website and GitHub repository. +Keep in mind that this build might crash frequently or contain bugs! -Beta releases let you test out new features, which may be buggy: +Nightly releases are for internal team to test new feature build everyday, which is very be buggy: -- **Jan GitHub repository**: [Github](https://github.com/janhq/jan/actions/workflows/jan-electron-build-nightly.yml) +[Download Jan's Nightly Version](https://app.jan.ai/download/nightly/mac-universal) -Keep in mind that this build might crash frequently and may contain bugs! +Keep in mind that this build crashes frequently or contains bugs! -### Step 2: Install the Jan Application +### Step 2: Install 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. +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 @@ -103,43 +106,34 @@ By default, Jan is installed in the following directory: # Default installation directory ~/Library/Application\ Support/Jan/data ``` +See [Jan Data Folder](/docs/data-folder) for more details about the data folder structure. - -- Please see the [Jan Data Folder](/docs/data-folder) for more details about the data folder structure. - -## Metal Acceleration +## Uninstall Jan +### 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** -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](https://developer.apple.com/documentation/metal)**, Apple's latest technology that can be used for GPU acceleration, so you don’t need to turn on this feature manually. +### Clean Up Data (Optional) - -💡 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. -6. Use the following command to delete Jan's user data and app cache: +Open **Terminal** and run these commands to remove all Jan-related data: ```bash # Remove all user data rm -rf ~/jan -# Delete the application data +# Delete application data rm -rf ~/Library/Application\ Support/Jan/data -# Delete the application cache +# Delete application cache rm -rf ~/Library/Application\ Support/Jan/cache ``` +This will completely remove Jan and all associated data from your system. {/* ## FAQs diff --git a/docs/src/pages/docs/desktop/windows.mdx b/docs/src/pages/docs/desktop/windows.mdx index 30f0b9918..f22f8984b 100644 --- a/docs/src/pages/docs/desktop/windows.mdx +++ b/docs/src/pages/docs/desktop/windows.mdx @@ -27,88 +27,77 @@ import FAQBox from '@/components/FaqBox' # Windows Installation To install Jan desktop on Windows, follow the steps below: ## Compatibility - Ensure that your system meets the following requirements to use Jan effectively: - - -- Windows 10 or higher. - - +- **Operating System**: Windows 10 or higher. +- **CPU** - -- Jan supports a processor that can handle AVX2. For the full list, please see [here](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#CPUs_with_AVX2). -- We support older processors with AVX and AVX-512, though this is not recommended. - -- Haswell processors (Q2 2013) and newer. -- Tiger Lake (Q3 2020) and newer for Celeron and Pentium processors. +- Intel: Haswell (Q2 2013) or newer +- Intel Celeron/Pentium: Tiger Lake (Q3 2020) or newer - -- Jan supports a processor that can handle AVX2. For the full list, please see [here](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#CPUs_with_AVX2). -- We support older processors with AVX and AVX-512, though this is not recommended. - - Excavator processors (Q2 2015) and newer. - - -- 8GB for running up to 3B models (int4). -- 16GB for running up to 7B models (int4). -- 32GB for running up to 13B models (int4). - -We support DDR2 RAM as the minimum requirement but recommend using newer generations of RAM for improved performance. - +- Jan requires a processor with AVX2 for best performance. See [full list of supported processors.](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#CPUs_with_AVX2) +- While older processors with AVX/AVX-512 will work, you may experience slower performance. - - -- 6GB can load the 3B model (int4) with `ngl` at 120 ~ full speed on CPU/ GPU. -- 8GB can load the 7B model (int4) with `ngl` at 120 ~ full speed on CPU/ GPU. -- 12GB can load the 13B model (int4) with `ngl` at 120 ~ full speed on CPU/ GPU. - +- **Memory (RAM)** + - 8GB → 3B parameter models (int4) + - 16GB → 7B parameter models (int4) + - 32GB → 13B parameter models (int4) + +DDR2 RAM is supported but newer RAM generations are recommended for better performance. + +- **GPU**: + - 6GB → 3B models with number of GPU layers (`ngl`) at 120 (full speed) + - 8GB → 7B models with number of GPU layers (`ngl`) at 120 (full speed) + - 12GB → 13B models with number of GPU layers (`ngl`) at 120 (full speed) Having at least 6GB VRAM when using NVIDIA, AMD, or Intel Arc GPUs is recommended. - - - -- At least 10GB for app storage and model download. - - -## Installing Jan +- **Storage:** Minimum 10GB free space for application and model downloads + + +## Install Jan To install Jan, follow the steps below: -### Step 1: Download the Jan Application +### Step 1: Download Application -Jan provides two types of releases: - +Jan provides 3 types of releases: + -#### Stable Releases +Please download Jan from official distributions, or build it from source. -The stable release is a stable version of Jan. You can download a stable release Jan app via the following: +- [Download Jan's Stable Version](https://app.jan.ai/download/latest/win-x64) +- Official Website: https://jan.ai/download -- **Official Website**: [https://jan.ai](https://jan.ai/) -- **Jan GitHub repository**: [Github](https://github.com/janhq/jan/releases) + + + +Beta releases let you test new features, which may be buggy: + +[Download Jan's Beta Version](https://app.jan.ai/download/beta/win-x64) -Make sure to verify the URL to ensure that it's the official Jan website and GitHub repository. +Keep in mind that this build might crash frequently or contain bugs! -#### Nightly Releases -The nightly Release allows you to test out new features and get a sneak peek at what might be included in future stable releases. You can download this version via: +Nightly releases are for internal team to test new feature build everyday, which is very be buggy: -- **Jan GitHub repository**: [Github](https://github.com/janhq/jan/actions/workflows/jan-electron-build-nightly.yml) +[Download Jan's Nightly Version](https://app.jan.ai/download/nightly/win-x64) -Keep in mind that this build might crash frequently and may contain bugs! +Keep in mind that this build crashes frequently or contains bugs! -### Step 2: Install the Jan Application + +### Step 2: Install Application 1. Once you have downloaded the Jan app `.exe` file, open the file. 2. Wait for Jan to be completely installed on your machine. @@ -172,7 +161,7 @@ To enable the use of your Intel Arc GPU in the Jan app, you need to activate the 5. A success notification saying **Successfully turned on GPU acceleration** will appear when GPU acceleration is activated. -## Uninstalling Jan +## Uninstall Jan To uninstall Jan, follow the steps below: @@ -181,7 +170,7 @@ To uninstall Jan, follow the steps below: 1. Open the **Control Panels**. 2. Click **Uninstall Program** under the **Programs** section. -### Step 2: Uninstall Jan App +### Step 2: Uninstall Application 1. Search for **Jan**. 2. Click the **three dots icon** -> **Uninstall**.