Gamified recycling for Angola. Scan materials with your phone camera and earn kwanzas, with material classification and reward calculation grounded by Microsoft Foundry IQ. Built with React 19, Vite, Firebase, and Express.
# 🦾 Prox-Recycle — Eco-Bounty Platform
> **Agents League Hackathon 2026 · Track: 🎨 Creative App · Microsoft IQ: Foundry IQ**
A **Cyber-Eco** gamified recycling platform for emerging markets (initial focus: Angola).
Citizens become *Agents* who hunt waste "bounties" on a tactical map, scan their haul
with an AI camera, and earn **Kanza (Kz)** credits payable to mobile money wallets
(e.g. Unitel Money).
Every reward is **grounded and citation-backed by Microsoft Foundry IQ** — so payouts
are auditable, traceable, and resistant to hallucination.
---
## � Screenshots
| Bounty Map | Bounty Detail | Wallet Hub | Leaderboard |
|:---:|:---:|:---:|:---:|
| | | | |
| Tactical map of live recycling bounties | Surge-priced bounty detail | Kanza balance & daily impact goal | Ranking by total mass recovered |
▶️ **Demo video:** demo-video/prox-recycle-demo.mp4 — a 55s walkthrough of the full flow, including the live Foundry IQ grounded scan with citations.
---
## �💡 Microsoft IQ Integration — Foundry IQ
This project integrates the **Foundry IQ** intelligence layer (Azure AI Foundry):
*"agentic knowledge retrieval that delivers cited, grounded answers to reduce hallucination."*
The scanner runs a **two-step pipeline** so that the reasoning stays transparent and auditable:
| Step | Model | Role |
|------|-------|------|
| **1. Vision** | Groq (`meta-llama/llama-4-scout-17b-16e-instruct`) | Looks at the photo and describes the item in plain text (material, condition, rough size). |
| **2. Reasoning** | **Foundry IQ** (`Phi-4-mini-instruct`) | Takes that description and **grounds** it against the recycling knowledge base — classifies the material, computes a fair reward, estimates CO₂ saved, and flags fraud. |
| **Citations** | — | Every scan returns the knowledge-base entry IDs Foundry IQ relied on (e.g. `PRICE-PET`, `CO2-ALU`, `FRAUD-STOCK`), shown live in the scanner UI. |
Splitting *seeing* from *reasoning* means the reward decision is made by Foundry IQ agains …