AmariahAK/Amani-OS

# Amani OS — Chama Dispute Arbitrator **Live demo:** amani-os-885974230787.europ… > **Hackathon track:** Challenge 02 — The Chama Dispute Arbitrator > Kenya has 300,000+ registered chamas. Billions of shillings move through them every year. The biggest threat is not bad investments — it is **unresolved fights between members**. Amani OS gives the treasurer an AI mediator that cites the chama’s own bylaws and payment records, in English, Kiswahili, or Sheng. --- ## The problem we are solving When two members clash — late M-Pesa contributions, loan defaults, meeting absences, expulsion votes — the treasurer is stuck in the middle. They are not a lawyer. Arguments get emotional. WhatsApp threads go in circles. The committee meeting gets heated, and sometimes the dispute never gets a clear ruling tied to the bylaws. **Amani OS** is an AI arbitration assistant a chama treasurer can open when things get heated. It: - Reads the chama’s **bylaws** and cites the right articles (e.g. Article 3.3 penalties, Article 7 dispute process). - Checks **M-Pesa / contribution records** (demo Paybill 247247 data in this build). - Looks up the **member register** (status, missed months, roles). - Answers in the **same language the treasurer uses** — English, Kiswahili, or Sheng. - Produces structured **rulings** and tables the committee can review. This repository is a working prototype for **Amani Investment Chama** (synthetic demo data). It is not legal advice; rulings should always be verified by humans before action. --- ## Agent architecture Amani OS uses a **single orchestrator agent** (not a multi-agent swarm). One agent loop plans, calls tools, and streams the final answer to the UI. ```mermaid flowchart TB subgraph ui [React UI - Vite] Chat[Chat + Composer] Ctx[Chama Context panel] Setup[Setup - provider / API key / model] end subgraph agent [pi-agent-core Agent] SP[System prompt + skills/*.md] Loop[Agent loop - stream / tools / retry] end su …