From 2460dc6885cba0c9c4499a66ca2a645a86cd457c Mon Sep 17 00:00:00 2001
From: thomageanderson <thomageanderson@gmail.com>
Date: Wed, 29 Jan 2025 15:17:41 -0500
Subject: [PATCH] docs: update installation guides to specify Python 3.11 and
 remove redundant Git install

---
 docs/installation/linux.md   |  9 +++++++--
 docs/installation/macos.md   | 16 ++++++----------
 docs/installation/windows.md |  8 ++++----
 3 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/docs/installation/linux.md b/docs/installation/linux.md
index 018ae3030..b79950a7e 100644
--- a/docs/installation/linux.md
+++ b/docs/installation/linux.md
@@ -41,8 +41,13 @@ Key services that will be running:
    sudo apt-get install git
    ```
 
-4. **Python Tools**
+4. **Python 3.11**
    ```bash
+   # Add deadsnakes PPA for Python 3.11
+   sudo add-apt-repository ppa:deadsnakes/ppa
+   sudo apt-get update
+   sudo apt-get install python3.11 python3.11-venv python3.11-dev
+   sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
    sudo apt-get install python3-pip
    python3 -m pip install --user pipx
    python3 -m pipx ensurepath
@@ -71,7 +76,7 @@ Magick uses [Clerk](https://clerk.com/) for authentication. You'll need to set u
 2. **Install Dependencies**
 
    ```bash
-   npm install
+   npm install --python=python3.11
    ```
 
 3. **Configure Environment**
diff --git a/docs/installation/macos.md b/docs/installation/macos.md
index 082c89ac3..4a1872f2d 100644
--- a/docs/installation/macos.md
+++ b/docs/installation/macos.md
@@ -20,19 +20,13 @@ Key services that will be running:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    ```
 
-2. **Git**
-
-   ```bash
-   brew install git
-   ```
-
-3. **Node.js 18+**
+2. **Node.js 18+**
 
    ```bash
    brew install node@18
    ```
 
-4. **Docker Desktop**
+3. **Docker Desktop**
 
    ```bash
    brew install --cask docker
@@ -40,8 +34,10 @@ Key services that will be running:
 
    Start Docker Desktop from Applications folder
 
-5. **Python Tools**
+4. **Python 3.11**
    ```bash
+   brew install python@3.11
+   brew link python@3.11
    brew install pipx
    pipx ensurepath
    ```
@@ -69,7 +65,7 @@ Magick uses [Clerk](https://clerk.com/) for authentication. You'll need to set u
 2. **Install Dependencies**
 
    ```bash
-   npm install
+   npm install --python=python3.11
    ```
 
 3. **Configure Environment**
diff --git a/docs/installation/windows.md b/docs/installation/windows.md
index d89b95f8c..dad5e7fc7 100644
--- a/docs/installation/windows.md
+++ b/docs/installation/windows.md
@@ -36,10 +36,10 @@ Key services that will be running:
      - Start Docker Desktop
      - Wait for the engine to start (check system tray icon)
 
-4. **Python Tools**
-   - Download and install Python from [python.org](https://www.python.org/downloads/)
+4. **Python 3.11**
+   - Download and install Python 3.11 from [python.org](https://www.python.org/downloads/release/python-3115/)
    - During installation:
-     - Check "Add Python to PATH"
+     - Check "Add Python 3.11 to PATH"
      - Choose "Customize installation"
      - Enable "pip" in optional features
    ```cmd
@@ -70,7 +70,7 @@ Magick uses [Clerk](https://clerk.com/) for authentication. You'll need to set u
 2. **Install Dependencies**
 
    ```cmd
-   npm install
+   npm install --python=python3.11
    ```
 
 3. **Configure Environment**