Skip to main content
Looking for C++? This page covers Python prerequisites. For C++ prerequisites (CMake, C++17 compiler), see the C++ Setup.

​
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)
Node.js20.20.0 via NVM (optional, required for MCP)
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.
For detailed hardware specs, see the Lemonade supported configurations.

​
Install Prerequisites

Quick Install Available: Skip this page if you’re using the Agent UI or one-command installer - they handle all prerequisites automatically.
For manual installation or development, follow the steps below to install uv. Lemonade Server will be installed automatically when you run gaia init.

​
Step 1: 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

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

Only required if you plan to use:
  • MCP servers with npx commands (filesystem, GitHub, Slack, etc.)
  • Electron desktop app development
NVM (Node Version Manager) manages Node.js versions, similar to how uv manages Python.
winget install CoreyButler.NVMforWindows
After installing NVM, restart PowerShell, then install Node.js:
nvm install 20.20.0
nvm use 20.20.0
Set as default version (optional):
nvm alias default 20.20.0
Verify installation:
node --version
npm --version
Having issues? Check the Troubleshooting guide, create an issue on GitHub, or contact us at [email protected].