Setup

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

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)

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.

Windows
Linux

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].

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

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.Install NVM:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Restart your terminal or run:

source ~/.bashrc  # or ~/.zshrc for Zsh

Install Node.js:

nvm install 20.20.0
nvm use 20.20.0
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].

Getting Started

C++ Framework

Python Framework

System Requirements

Install Prerequisites

Step 1: Install uv

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

Step 1: Install uv

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

​System Requirements

​Install Prerequisites

​Step 1: Install uv

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

​Step 1: Install uv

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

System Requirements

Install Prerequisites

Step 1: Install uv

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

Step 1: Install uv

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