The project showcases how AI and blockchain can empower patients across Africa to own, secure, and understand their health data.
# MedBlocAI
> **Empowering African Patients with AI + Blockchain Health Records**
## Overview
**MedBlocAI** is a decentralized health record platform that combines **blockchain** and **AI** to help patients across Africa:
- **Own** their medical data securely
- **Store** records on IPFS with blockchain verification
- **Understand** health insights through AI analysis
- **Control** who accesses their information
## Architecture
```
React Frontend ← → Base Sepolia Smart Contract
(RainbowKit) ↓
↓ HealthRecordRegistry
Web3.Storage ↓
(IPFS) Flask AI Service
```
## Features
- **Multi-Wallet Support** - Connect with RainbowKit (MetaMask, WalletConnect, Coinbase, etc.)
- **Decentralized Storage** - Health records on IPFS
- **Blockchain Registry** - Immutable record hashes on Base L2
- **AI Health Analysis** - Symptom analysis and recommendations
- **Patient Privacy** - Only you control your data
## Tech Stack
| Layer | Technology |
|-------|------------|
| **Frontend** | React, Vite, Tailwind CSS, RainbowKit, wagmi, viem |
| **Blockchain** | Solidity, Hardhat, Base Sepolia |
| **Storage** | IPFS (web3.storage) |
| **AI Backend** | Flask, Python, scikit-learn |
| **Deployment** | Vercel (Frontend), Render (Backend) |
## Project Structure
```
medblocai/
├── frontend/ # React + Vite application
│ ├── src/
│ │ ├── components/
│ │ ├── hooks/
│ │ ├── utils/
│ │ └── App.jsx
│ └── package.json
├── contracts/ # Solidity smart contracts
│ └── HealthRecordRegistry.sol
├── backend/ # Flask AI service
│ ├── app.py
│ ├── ai_model.py
│ └── requirements.txt
├── scripts/ # Deployment scripts
│ └── deploy.js
├── test/ # Contract tests
│ └── HealthRecordRegistry.test.js
└── hardhat.config.js
```
## Setup & Installation
### Prerequisites
- Node.js v18+
- Python 3.9+
- MetaMask or any Web3 wallet
- Git
### 1. Clone the repository
```bash
git clone …