CoopWise is an AI and blockchain-powered cooperative savings platform designed for Africa’s financial realities. It digitizes traditional savings models like Ajo, Esusu, and Chamas, offering programmable stablecoin escrows, transparent group governance, and AI-driven insights. With smart contract automation and fiat on/off-ramps via CashRamp, CoopWise empowers communities with modern, decentralized financial infrastructure.

• 🔐 Authentication & Identity Verification
• 🤖 AI-Powered Cooperative Insights & Financial Nudges
• 🌍 Group Creation, Joining, and Discovery
• 💰 Stablecoin Wallets & Seamless Contributions
• 📈 Smart Dashboards with Contribution Tracking
• 📬 Real-time Notifications & Invitations
• 🛠️ Admin and Support Channels for Dispute Resolution
• 💬 AI Interview Chat (Beta)

olaniyigeorge-coopwise/
│
├── backend_api/         → FastAPI backend (versioned routes, services, models, utils)
│   ├── app/             → Core app logic: APIs, schemas, services, etc.
│   ├── db/              → SQLAlchemy models and DB logic
│   ├── main.py          → Entrypoint for backend
│
├── frontend/            → Next.js frontend (app directory structure, components, styling)
│   ├── app/             → Pages, routes, layout
│   ├── components/      → UI and dashboard components
│   ├── lib/             → API & state management logic
│   ├── hooks/, types/   → Shared utilities and types
│
├── docker-compose.yml   → Multi-service orchestration
├── todo.md              → Pending or planned features
├── README.md            → You're here

git clone https://github.com/olaniyigeorge/coopwise.git
cd coopwise

cd backend_api
cp .env.sample .env
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

cd backend_api
cp .env.sample .env
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

cd frontend
yarn
yarn dev

docker-compose up --build

AI Insights are generated based on group contribution patterns, saving behavior, and cooperative health. This includes:

• Intelligent savings reminders
• Group performance summaries
• Personalized financial nudges
• Onboarding insights for new users
• Backed by llm_client.py and insights_service.py, this engine can be extended with templates and session context.

Base URL: /api/v1

• /auth Login, Register, Verify
• /users Profile, KYC, Me
• / groups Create, Join, Discover
• /memberships Invite, Accept, Roles
• /contributions Make, View, Summary
• /wallet Fund wallet, View balance
• /dashboard AI insights, analytics
• /notifications Realtime alerts
• /ai-chat Chat interface (experimental)

Backend tests (use pytest):

pytest

Frontend tests (if enabled):

yarn test

We welcome contributors building towards better financial systems for Africa.

Use feature branches

• Follow PEP8 for Python and ESM for Next.js
• Document new routes or services in todo.md

We leverage:

• CashRamp(Accurue) GraphQL for payment settlement and stablecoin integration
• Audit logging for all wallet and contribution events
• JWT encryption and secure session handling
• Clear roles & permission enforcement

MIT License. See LICENSE.md file.

NexaScale & Accurue Hackathon 2025 CashRamp Team for open APIs OpenAI for GPT-4o API access

Let’s build Africa’s future of savings. ✨