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) |
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.
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: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).curl -LsSf https://astral.sh/uv/install.sh | sh
Verify uv is installed (restart terminal if needed):