Setup

Looking for Python? This page covers C++ prerequisites. For Python prerequisites (uv, Node.js), see the Python Setup.

System Requirements

Requirement	Supported
OS	Windows 11, Ubuntu 24.04+
CPU	Any x86_64 processor
RAM	8GB minimum, 16GB+ recommended
Disk	~500MB for build artifacts and fetched dependencies

Install Prerequisites

Windows
Linux

Step 1: Install a C++ Compiler

You need a compiler with C++17 support. Visual Studio 2019 or later is recommended.Install the free Visual Studio Community edition with the “Desktop development with C++” workload:

Download from visualstudio.microsoft.com
In the installer, select Desktop development with C++
Click Install

Verify the compiler is available (open Developer Command Prompt):

cl

Already have Visual Studio? Make sure the “Desktop development with C++” workload is installed via the Visual Studio Installer.

Step 2: Install CMake

CMake 3.14 or later is required.

winget install Kitware.CMake

Verify (restart your terminal if needed):

cmake --version

CMake is also bundled with Visual Studio. If you selected the C++ workload, you may already have it — check with cmake --version first.

Step 3: Install Git

Git is required by CMake FetchContent to download dependencies automatically.

winget install Git.Git

Verify (restart your terminal if needed):

git --version

Step 4: Install Lemonade Server

The agent needs an OpenAI-compatible LLM server. Lemonade Server is recommended (optimized for AMD hardware).Download and run the installer (v2026.43.3):

# Download the MSI installer
curl -L -o lemonade-server-minimal.msi https://github.com/lemonade-sdk/lemonade/releases/download/v2026.43.3/lemonade-server-minimal.msi

# Run the installer
msiexec /i lemonade-server-minimal.msi

Or download directly from the Lemonade v2026.43.3 release page.After installation, restart your terminal and start the server. gaia daemon resolves and supervises it in the background, so the terminal stays free:

gaia daemon start

Not using Lemonade? Any OpenAI-compatible server works — llama.cpp, Ollama, vLLM, or a cloud endpoint. See the Integration Guide for configuration examples.

Optional: Install uvx (for MCP demos)

The System Health Agent demo requires uvx to launch the Windows MCP server. If you only plan to use the Wi-Fi Troubleshooter or build your own agent, you can skip this.

pip install uv

Verify:

uvx --version

Having issues? Check the Troubleshooting guide, create an issue on GitHub, or contact us at [email protected].

Step 1: Install a C++ Compiler

You need a compiler with C++17 support. GCC 9 or later is recommended.

sudo apt update
sudo apt install build-essential

Verify:

g++ --version

Step 2: Install CMake

CMake 3.14 or later is required.

sudo apt install cmake

Verify:

cmake --version

If your distribution ships an older CMake, install a newer version from cmake.org/download or via pip install cmake.

Step 3: Install Git

Git is required by CMake FetchContent to download dependencies automatically.

sudo apt install git

Verify:

git --version

Step 4: Install Lemonade Server

The agent needs an OpenAI-compatible LLM server. Lemonade Server is recommended (optimized for AMD hardware).Install via the Launchpad PPA (Ubuntu 24.04+):

sudo add-apt-repository ppa:lemonade-team/stable
sudo apt-get update
sudo apt-get install -y lemonade-server

Or browse all platform options on the Lemonade v2026.43.3 release page.After installation, start the server. gaia daemon resolves and supervises it in the background, so the terminal stays free:

gaia daemon start

Not using Lemonade? Any OpenAI-compatible server works — llama.cpp, Ollama, vLLM, or a cloud endpoint. See the Integration Guide for configuration examples.

Optional: Install uvx (for MCP demos)

The System Health Agent demo requires uvx to launch the Windows MCP server. If you only plan to use the Wi-Fi Troubleshooter or build your own agent, you can skip this.

pip install uv

Verify:

uvx --version

Having issues? Check the Troubleshooting guide, create an issue on GitHub, or contact us at [email protected].

Prerequisites Summary

Tool	Minimum Version	How to Verify
C++ Compiler	C++17 support (MSVC 2019+ or GCC 9+)	`cl` (Windows) or `g++ --version` (Linux)
CMake	3.14+	`cmake --version`
Git	any	`git --version`
Lemonade Server	2026.43.3	`lemonade --version`
uvx	any (optional)	`uvx --version`

All C++ library dependencies (nlohmann/json, cpp-httplib, yaml-cpp, Google Test) are fetched automatically by CMake during the build — no manual installs required.

Getting Started

C++ Framework

Python Framework

System Requirements

Install Prerequisites

Step 1: Install a C++ Compiler

Step 2: Install CMake

Step 3: Install Git

Step 4: Install Lemonade Server

Optional: Install uvx (for MCP demos)

Step 1: Install a C++ Compiler

Step 2: Install CMake

Step 3: Install Git

Step 4: Install Lemonade Server

Optional: Install uvx (for MCP demos)

Prerequisites Summary

​System Requirements

​Install Prerequisites

​Step 1: Install a C++ Compiler

​Step 2: Install CMake

​Step 3: Install Git

​Step 4: Install Lemonade Server

​Optional: Install uvx (for MCP demos)

​Step 1: Install a C++ Compiler

​Step 2: Install CMake

​Step 3: Install Git

​Step 4: Install Lemonade Server

​Optional: Install uvx (for MCP demos)

​Prerequisites Summary

System Requirements

Install Prerequisites

Step 1: Install a C++ Compiler

Step 2: Install CMake

Step 3: Install Git

Step 4: Install Lemonade Server

Optional: Install uvx (for MCP demos)

Step 1: Install a C++ Compiler

Step 2: Install CMake

Step 3: Install Git

Step 4: Install Lemonade Server

Optional: Install uvx (for MCP demos)

Prerequisites Summary