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
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):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
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.Verify (restart your terminal if needed):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 (v10.0.0):# Download the MSI installer
curl -L -o lemonade-server-minimal.msi https://github.com/lemonade-sdk/lemonade/releases/download/v10.0.0/lemonade-server-minimal.msi
# Run the installer
msiexec /i lemonade-server-minimal.msi
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.Verify: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
Step 2: Install CMake
CMake 3.14 or later is required.Verify: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.Verify:Step 4: Install Lemonade Server
The agent needs an OpenAI-compatible LLM server. Lemonade Server is recommended (optimized for AMD hardware).Download and install the .deb package (v10.0.0):# Download the .deb package
curl -L -o lemonade-server_10.0.0_amd64.deb https://github.com/lemonade-sdk/lemonade/releases/download/v10.0.0/lemonade-server_10.0.0_amd64.deb
# Install it
sudo dpkg -i lemonade-server_10.0.0_amd64.deb
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.Verify:
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 | 10.0.0 | lemonade-server --version |
| uvx | any (optional) | uvx --version |
All C++ library dependencies (nlohmann/json, cpp-httplib, Google Test) are fetched automatically by CMake during the build — no manual installs required.