> ## Documentation Index
> Fetch the complete documentation index at: https://amd-gaia.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Install prerequisites for GAIA

<Note>
  **Looking for C++?** This page covers Python prerequisites. For C++ prerequisites (CMake, C++17 compiler), see the [C++ Setup](/docs/cpp/setup).
</Note>

## System Requirements

| Requirement | Supported                                                               |
| ----------- | ----------------------------------------------------------------------- |
| **NPU**     | AMD Ryzen AI 300-series                                                 |
| **GPU**     | AMD Radeon RX 7000/9000-series, Radeon PRO W-series                     |
| **CPU**     | Any x86\_64 processor (slower, but works without dedicated AI hardware) |
| **OS**      | Windows 11, Ubuntu 24.04+                                               |
| **RAM**     | 16GB minimum, 64GB recommended                                          |
| **Python**  | 3.10 - 3.12 (uv installs automatically)                                 |
| **Node.js** | 20.20.0 via NVM (optional, required for MCP)                            |

<Tip>
  **Recommended Configuration:** The SDK has been primarily tested on a GMKtec NucBox EVO-X2 with AMD Ryzen AI MAX+ 395 w/ Radeon 8060S (or comparable) with 128GB RAM, using the Qwen3.5-35B-A3B-GGUF LLM running on the iGPU.
</Tip>

<Note>
  For detailed hardware specs, see the [Lemonade supported configurations](https://github.com/lemonade-sdk/lemonade?tab=readme-ov-file#supported-configurations).
</Note>

***

## Install Prerequisites

<Info>
  **Quick Install Available:** Skip this page if you're using the [Agent UI](/docs/quickstart#agent-ui-npm) or [one-command installer](/docs/quickstart#cli-install) - they handle all prerequisites automatically.
</Info>

For manual installation or development, follow the steps below to install uv. Lemonade Server will be installed automatically when you run `gaia init`.

<Tabs>
  <Tab title="Windows">
    ### Step 1: Install uv

    [uv](https://docs.astral.sh/uv/) is a fast Python package manager (10-100x faster than pip).

    Open **PowerShell** and run:

    ```powershell theme={null}
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    ```

    <Tip>
      If `uv` is not recognized after install, restart PowerShell or run:

      ```powershell theme={null}
      $env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
      ```
    </Tip>

    Verify uv is installed:

    ```powershell theme={null}
    uv --version
    ```

    ### Step 2: Install Node.js via NVM (Optional)

    <Note>
      **Only required if you plan to use:**

      * MCP servers with `npx` commands (filesystem, GitHub, Slack, etc.)
      * Electron desktop app development
    </Note>

    [NVM](https://github.com/coreybutler/nvm-windows) (Node Version Manager) manages Node.js versions, similar to how uv manages Python.

    ```powershell theme={null}
    winget install CoreyButler.NVMforWindows
    ```

    After installing NVM, **restart PowerShell**, then install Node.js:

    ```powershell theme={null}
    nvm install 20.20.0
    nvm use 20.20.0
    ```

    Set as default version (optional):

    ```powershell theme={null}
    nvm alias default 20.20.0
    ```

    Verify installation:

    ```powershell theme={null}
    node --version
    npm --version
    ```

    <Success>
      You're ready to install GAIA! Continue to the [Quickstart](/docs/quickstart).
    </Success>

    <Tip>
      **Having issues?** Check the [Troubleshooting](/docs/reference/troubleshooting) guide, [create an issue](https://github.com/amd/gaia/issues) on GitHub, or contact us at [gaia@amd.com](mailto:gaia@amd.com).
    </Tip>
  </Tab>

  <Tab title="Linux">
    ### Step 1: Install uv

    [uv](https://docs.astral.sh/uv/) is a fast Python package manager (10-100x faster than pip).

    ```bash theme={null}
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```

    Verify uv is installed (restart terminal if needed):

    ```bash theme={null}
    uv --version
    ```

    ### Step 2: Install Node.js via NVM (Optional)

    <Note>
      **Only required if you plan to use:**

      * MCP servers with `npx` commands (filesystem, GitHub, Slack, etc.)
      * Electron desktop app development
    </Note>

    [NVM](https://github.com/nvm-sh/nvm) (Node Version Manager) manages Node.js versions, similar to how uv manages Python.

    Install NVM:

    ```bash theme={null}
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
    ```

    Restart your terminal or run:

    ```bash theme={null}
    source ~/.bashrc  # or ~/.zshrc for Zsh
    ```

    Install Node.js:

    ```bash theme={null}
    nvm install 20.20.0
    nvm use 20.20.0
    nvm alias default 20.20.0
    ```

    Verify installation:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Success>
      You're ready to install GAIA! Continue to the [Quickstart](/docs/quickstart).
    </Success>

    <Tip>
      **Having issues?** Check the [Troubleshooting](/docs/reference/troubleshooting) guide, [create an issue](https://github.com/amd/gaia/issues) on GitHub, or contact us at [gaia@amd.com](mailto:gaia@amd.com).
    </Tip>
  </Tab>
</Tabs>

***

<small style="color: #666;">
  **License**

  Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved.

  SPDX-License-Identifier: MIT
</small>