Getting Started Installation

Installation Guide

This guide covers building AgentMesh from source, compiling the C++20 core engine, and setting up the Python adapter.

---

System Requirements

Component	Minimum Version	Recommended
OS	macOS Darwin (ARM64/x86_64) or Linux (Ubuntu 20.04+)	macOS Apple Silicon or Linux Ubuntu 22.04
C++ Compiler	Clang 15+ or GCC 12+ (C++20 required)	Clang 17+ or GCC 13+
Build System	CMake 3.20+, Make or Ninja	CMake 3.28+ with Ninja
Python	Python 3.10+	Python 3.11 or 3.12 with uv
PostgreSQL	libpq 14+ (Optional for WAL persistence)	libpq 16+

---

1. Clone Repository

git clone https://github.com/DevrG03/AgentMesh.git
cd AgentMesh/Phase1

---

2. Python Environment Setup via uv

AgentMesh relies on uv for deterministic, sub-second dependency resolution:

# Install dependencies from pyproject.toml
uv sync

This installs langgraph, pybind11, pytest, httpx, yfinance, and groq.

---

3. Build Python Extension (agentmesh_core)

Compile the Pybind11 C++ shared library:

cd python_adapter

c++ -O3 -Wall -shared -std=c++20 -fPIC -undefined dynamic_lookup \
    $(uv run python -m pybind11 --includes) \
    agentmesh_pybind.cpp \
    -o agentmesh_core$(uv run python -c "import sysconfig; print(sysconfig.get_config_var('EXT_SUFFIX'))")

Verify the binary was created:

uv run python -c "import agentmesh_core; print('AgentMesh Core successfully loaded!')"

---

4. Build C++ Standalone Suite & Unit Tests

To compile the native C++ library, binaries, and CTest suite:

cd ..
mkdir -p build && cd build
cmake ..
make -j8

# Run full C++ test harness (M1-M9)
ctest --output-on-failure

---

5. Validate Parity Test Suite

Run the full LangGraph 6/6 API Parity test suite:

cd ..
PYTHONPATH=python_adapter uv run python tests/test_langgraph_parity.py

Expected output:

TEST 1 PASSED: TypedDict Annotated Reducers verified.
TEST 2 PASSED: Multi-target conditional fan-out verified.
TEST 3 PASSED: Send() dynamic map-reduce verified.
TEST 4 PASSED: Command(goto=..., update=...) verified.
TEST 5 PASSED: Nested Subgraph verified.
TEST 6 PASSED: Async & Streaming verified.

ALL LANGGRAPH PARITY TESTS PASSED 100%!
```\n