Skip to main content
Glama
README.md
# AgentBridge Africa

<p align="center">
  <img src="docs/assets/social-preview.svg" alt="AgentBridge Africa: bounded multi-agent execution with hard budgets and regional context" width="100%" />
</p>

<p align="center">
  <strong>Multi-agent bridge with hard budgets and regional context</strong><br/>
  ContextProfile · BudgetGuardian · Golden trajectory evals<br/>
  for African payment rails and operating environments
</p>

[![Python](https://img.shields.io/badge/Python-3.11+-blue?style=flat)]()
[![Status](https://img.shields.io/badge/Status-hard%20budgets%20%2B%20evals-brightgreen?style=flat)]()
[![License](https://img.shields.io/badge/License-MIT-yellow?style=flat)]()

---

## What problem does this solve?

Agent systems interacting with real rails need hard cost ceilings, local context, and failure-mode safety. Soft retries become infinite. AgentBridge makes budget a hard stop and evaluates every change against golden trajectories before expansion.

## Architecture

```mermaid
flowchart LR
  A[ContextProfile<br/>locale / currency / rails / offline] --> B[Planner]
  B --> C[Worker<br/>MCP-shaped tools]
  C --> D[BudgetGuardian<br/>hard stop]
  D --> E[Verifier]
  E --> F[Golden evals<br/>including failure injection]
```

**Stack:** Python 3.11+ · Pydantic v2 · PyYAML · pytest  
Eval harness runs fully offline.

## What is implemented

- ContextProfile (en-NG, en-KE, offline-NG)
- BudgetGuardian hard stop
- MCP-shaped envelopes with safety hints
- Golden YAML trajectories + failure injection
- Payments adapter (quote / execute / status)

## Quick start

```bash
pip install -r requirements.txt
make eval
```

## Demo

<!-- asciinema + agg recommended for CLI; screencli for future web UI -->

> Demo GIF coming soon. Run `make eval` to see 100% on expected outcomes.

## Portfolio value

Production-minded agent design for African contexts: hard budgets, regional profiles, deterministic evals.

## Limitations

Planner is deterministic. Live multi-rail adapters are stubbed for eval safety.

## Companion repositories

- [ArchAudit-CCM](https://github.com/Logonotobscurity/ArchAudit-CCM)
- [GigPilot](https://github.com/Logonotobscurity/GigPilot)

## Visual assets checklist

- [ ] Social preview (1280×640)
- [ ] Demo GIF of eval harness
- [ ] Logo in `docs/assets/`