OpenSparX/MasterAgent

# 🌳 OAK — Open Agent Kernel

The Linux kernel for AI agents.

Build agents that run 100% on-device. No cloud. No latency. No data leaks.

构建 100% 端侧运行的 AI Agent。无云端依赖，无网络延迟，无数据泄露。

[](LICENSE)

[](https://github.com/OpenSparX/MasterAgent/actions)

[](#-supported-hardware)

⚠️ Status: Alpha — Core kernel is functional. APIs are unstable. Contributions welcome.

git clone https://github.com/OpenSparX/MasterAgent.git && cd MasterAgent
cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j$(nproc)

[Quick Start](#-quick-start) · [Why OAK?](#-why-oak) · [Docs](#-documentation) · [中文文档](#中文)

## ⚡ 30-Second Demo

$ cmake -B build && cmake --build build -j$(nproc) && ctest --test-dir build

[100%] Built target bench_strategic
Test project /home/you/MasterAgent/build
    Start 1: test_integration_speculation
1/5 Test #1: test_integration_speculation .....   Passed    0.8 sec
    Start 2: test_orset
2/5 Test #2: test_orset .......................   Passed    0.4 sec
    Start 3: test_merkle
3/5 Test #3: test_merkle ......................   Passed    0.4 sec
    Start 4: test_embedding
4/5 Test #4: test_embedding ...................   Passed    0.4 sec
    Start 5: bench_strategic
5/5 Test #5: bench_strategic ..................   Passed    2.9 sec

100% tests passed, 0 tests failed out of 5

The OSS build compiles and tests the strategic features: speculative execution,

CRDT mesh sync, formal verification, and embedding search. The full CLI

(with model inference) requires the kernel runtime — see [Architecture](#-architecture).

## 🧠 Why OAK?

### ⚡ Sub-100ms

No network round-trip. 80% of requests resolve via pattern matching in microseconds. The other 20% run local LLM inference.

### 🔒 Private by Default

Data never leaves the device. No telemetry. No cloud calls. Encrypted-at-rest storage with device-bound keys.

### 🔋 NPU-Optimized

Develop on CPU anywhere. Deploy to Qualcomm NPU for 14× speedup at 3.5× less power. Same code, different backend.

### How OAK compares

## 🚀 Quick Start

### Build from Source

# Prerequisites: CMake 3.18+, C++17 compiler (GCC 9+, Clang 11+)
git clone https://github.com/OpenSparX/MasterAgent.git
cd MasterAgent
cmake -B build -DCMAKE_BUILD_TYPE=Release \
      -DMASTER_AGENT_BUILD_CLI=ON \
      -DMASTER_AGENT_BUILD_TESTS=ON
cmake --build build -j$(nproc)

# Run tests
ctest --test-dir build --output-on-failure

### Run with a Local Model (llama.cpp)

# The sparx CLI connects to any llama-server compatible endpoint.
# Start llama-server (install separately: https://github.com/ggml-org/llama.cpp)
llama-server -m your-model.gguf --port 8080

# Run the CLI
./build/cli/sparx run --endpoint 127.0.0.1:8080

### Run in Deterministic-Only Mode (No Model Needed)

# Deterministic skills respond without any model loaded
./build/cli/sparx demo automotive

💡 Most intent routing works without a model — only open-ended queries need LLM inference.

## 📦 What's Open Source

OAK uses an open-core model. This repository contains:

The proprietary kernel runtime handles task orchestration, WAL recovery, and agent dispatch. The strategic feature modules (the algorithmic innovations) are fully open and independently testable.

We're working toward open-sourcing the kernel runtime. Track progress in [#1](https://github.com/OpenSparX/MasterAgent/issues/1).

## 🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         User Input                               │
└──────────────────────────────┬──────────────────────────────────┘
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│  Preprocessing: UTF-8 normalize → parameter extract → memory     │
└──────────────────────────────┬───────────────────────────────────┘
                               ▼