Skip to main content

System Requirements

RequirementSupported
NPUAMD Ryzen AI 300-series
GPUAMD Radeon RX 7000/9000-series, Radeon PRO W-series
CPUAny x86_64 processor (slower, but works without dedicated AI hardware)
OSWindows 11, Ubuntu 24.04+
RAM16GB minimum, 64GB recommended
Python3.10 - 3.12 (uv installs automatically)
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-Coder-30B-A3B-Instruct-GGUF LLM running on the iGPU.
For detailed hardware specs, see the Lemonade supported configurations.

Install Prerequisites

Follow the steps below to install Lemonade Server and uv, the two prerequisites for running GAIA.

Step 1: Install Lemonade Server

Download and install from lemonade-server.ai. GAIA starts it automatically when needed.

Step 2: Install uv

uv is a fast Python package manager (10-100x faster than pip).Open PowerShell and run:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
If uv is not recognized after install, restart PowerShell or run:
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
Verify uv is installed:
uv --version
Having issues? Check the Troubleshooting guide, create an issue on GitHub, or contact us at [email protected].