agents-cpp-sdk

[TOC]
# Agents-SDK - A High Performance C++ Framework for AI Agents

![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)
![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0)
![Windows](https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white)

**Agents-SDK** is a **portable, high-performance C++ framework** for building **on-device, agentic AI systems** — think **LangChain for the edge**. This SDK is purpose-built for developers who want to create **local-first AI agents** that can reason, plan, and act without relying on the cloud.

## Features

- **Modular Architecture** — Compose agents from interchangeable components.
- **Multi-Provider Support** — Connect to multiple LLM providers seamlessly:
  - **OpenAI** (GPT-5, GPT-4o, GPT-4)
  - **Anthropic** (Gemini 3 family models: Opus, Sonnet, Haiku)
  - **Google** (Gemini family models: Pro, Flash)
  - **Ollama/llama-cpp** (local models like Llama, Mistral, etc.)
- **Optimized for Speed and Memory** — Built in C++ with focus on performance.
- **Built-In Workflow Patterns**
  - Prompt Chaining
  - Routing
  - Parallelization
  - Orchestrator-Workers
  - Evaluator-Optimizer
- **Autonomous Agents** — Supports modern reasoning strategies:
  - ReAct (Reason + Act)
  - CoT (Chain-of-Thought)  [In Development]
  - Plan and Execute
  - Zero-Shot [In Development]
  - Reflexion [In Development]
- **Extensible Tooling System** — Plug in your own tools or use built-in ones (Web Search, Wikipedia, Python Executor, etc).

## Pre-requisites

- C++20 compatible compiler (GCC 14+, Clang 17+, MSVC 2022+)
- Bazel 8.3.1+ (https://bazel.build/install)

- Dependencies (already provided for convenience)
   - python3 (3.11+)
   - nlohmann/json
   - spdlog

## Quick Start

### Installation

1. Clone the repository:
   ```bash
   git clone https://github.com/RunEdgeAI/agents-sdk.git
   ```

2. Navigate to SDK:
   ```bash
   cd agents-sdk
   ```

3. Obtain A