NGO Co-Pilot & CSR Trust Oracle

A comprehensive, AI-powered platform designed to seamlessly connect CSR funders with on-the-ground NGO operations, ensuring 100% transparency, automation, and immutable impact tracking.

🌟 Overview

The NGO Co-Pilot & CSR Trust Oracle provides an end-to-end ecosystem for managing philanthropic funds. It eliminates manual overhead by using AI agents to:

1. Generate formal Project Charters
2. Curate vendor quotations and procurements
3. Digitize financial audits and physical vendor bills
4. Intelligently dispatch tasks to on-ground field agents based on GPS proximity

🚀 Core Modules

1. CSR Trust Oracle (Funder Dashboard)

• Live Impact Portfolio: Real-time visibility into how deployed funds are utilized.
• Immutable Ledger Audit: Review digitized physical receipts and double-entry ledgers generated by the Accountant AI.
• Geospatial Tracking: A live interactive map displaying the exact locations of active field tasks and agents.

2. NGO Command (Director Dashboard)

• Centralized Approvals: Review and approve AI-generated Project Charters.
• Financial Oversight: Manage vendor payments and review automated OCR-extracted bills.

3. Project Manager Workspace

• Charter Agent: Inputs basic goals to generate comprehensive, highly structured project charters using AI.
• Procurement Agent: Automatically analyzes approved charters to suggest materials, search for vendors, and curate quotes.
• Dispatch Agent: Assigns specific targets to Field Agents based on geolocation logic.
• Task Review: PM can approve or reject tasks completed by Field Agents in real-time.

4. Accountant Module (Vision AI)

• Vendor Bill Processing: Uses state-of-the-art Vision OCR AI to scan physical vendor receipts, extracting GSTINs, tax amounts, and base prices.
• Automated Ledgers: Seamlessly logs expenses to a double-entry General Ledger mimicking Indian standard auditing templates.

5. Field Agent Portal (Mobile-First)

• Task Execution: Agents receive assigned tasks on the ground.
• GPS Proof-of-Work: Built-in messenger UI to upload completion notes, which silently captures live GPS coordinates to prove impact delivery.

🛠 Tech Stack

• Frontend: Next.js (React), Tailwind CSS, Lucide Icons, Leaflet (Maps), Recharts
• Backend: FastAPI (Python), Uvicorn
• AI Core: Google Gemini 2.5 Flash (for Text Generation, Procurement Logic, and Vision OCR)
• Architecture: Monolithic MVP with loosely coupled modules. Fallback to Local JSON DB for robust offline demo presentations.

⚙️ Getting Started

Prerequisites

• Node.js (v18+)
• Python 3.10+
• Google Gemini API Key

Backend Setup

cd backend
python -m venv venv
venv\Scripts\activate  # Windows
pip install -r requirements.txt

# Create a .env file and add your API key
# GEMINI_API_KEY="your-api-key-here"

uvicorn main:app --reload

Frontend Setup

cd frontend
npm install
npm run dev

Visit http://localhost:3000 to interact with the platform.

📄 License

MIT License