verichain 2.4.1
Legal-grade accountability system for AI decisions with ATHENA, HELIOS, and ARES
Requires Python: >=3.8

# VeriChain™ - AI Accountability Platform

**Version:** 1.2.0 (Phase 1 Complete)  
**Status:** ✅ Production Ready  
**Date:** 18 Ottobre 2025

---

## 🚀 What is VeriChain?

VeriChain is the **only AI accountability platform** with:

- ✅ **Multi-Model AI** - 4 AI models with automatic fallback
- ✅ **Real-Time Bias Detection** - 8 protected classes, instant alerts
- ✅ **Fairness Metrics** - 5 advanced metrics (Equal Opportunity, Equalized Odds, etc.)
- ✅ **Compliance Automation** - GDPR, EU AI Act, CCPA, ISO 27001
- ✅ **Live Dashboard** - Real-time WebSocket streaming
- ✅ **Cryptographic Audit Trail** - Immutable, legally-binding records

---

## ⚡ Quick Start

### **1. Start Services**

```bash
# Backend (Docker)
docker-compose up -d

# Frontend (Dashboard)
cd dashboard-ui && npm run dev
```

### **2. Open Dashboard**

```
http://localhost:3000
```

### **3. Run Demo**

```bash
python3 sdk-python/examples/realtime_streaming_demo.py
```

**Watch decisions appear in real-time!** ✨

---

## 📚 Documentation

- **[GETTING_STARTED.md](GETTING_STARTED.md)** - Installation & setup
- **[TECHNICAL_GUIDE.md](TECHNICAL_GUIDE.md)** - Architecture & features
- **[API Documentation](http://localhost:8000/docs)** - Interactive API docs

---

## 🎯 Key Features

### **Multi-Model AI**
- DeepSeek, GPT-4, Claude, Gemini
- Automatic fallback
- Cost optimization
- Response caching

### **Bias Detection**
- 8 protected classes (age, gender, race, etc.)
- Demographic parity analysis
- Disparate impact (4/5 rule)
- Automatic severity scoring

### **Fairness Metrics**
- Demographic Parity
- Equal Opportunity
- Equalized Odds
- Predictive Parity
- Calibration

### **Compliance Automation**
- GDPR Article 22 compliance
- EU AI Act compliance
- CCPA compliance
- ISO 27001 alignment
- Automatic verification

### **Real-Time Dashboard**
- WebSocket streaming
- Live bias alerts
- Instant updates
- Multi-client support

---

## 🏗️ Architecture

```
┌─────────────────────────────────────────────────────────┐
│                    Dashboard (React)                    │
│                  http://localhost:3000                  │
└────────────────────┬────────────────────────────────────┘
                     │ WebSocket
                     ↓
┌─────────────────────────────────────────────────────────┐
│                  FastAPI Server                         │
│                http://localhost:8000                    │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐ │
│  │ Multi-Model  │  │    Bias      │  │  Compliance  │ │
│  │     AI       │  │  Detection   │  │   Checker    │ │
│  └──────────────┘  └──────────────┘  └──────────────┘ │
└────────────────────┬────────────────────────────────────┘
                     │
                     ↓
┌─────────────────────────────────────────────────────────┐
│              PostgreSQL + Redis                         │
│         Ledger + Cryptographic Storage                  │
└─────────────────────────────────────────────────────────┘
```

---

## 💰 Business Value

### **Before VeriChain:**
- Manual compliance reviews
- No bias detection
- Static audit trails
- Risk of violations

### **After VeriChain:**
- Automatic compliance (4 regulations)
- Real-time bias detection (8 protected classes)
- Live monitoring
- Zero compliance risk

### **ROI:**
- Avoid fines: $XXX,XXX+
- Faster deployment: 80% time saved
- Risk mitigation: Priceless

---

## 🧪 Testing

```bash
# Multi-Model AI
python3 sdk-python/examples/multi_model_ai_example.py

# Bias Detection
python3 sdk-python/examples/bias_detection_example.py

# Fairness Metrics
python3 sdk-python/examples/fairness_analysis_example.py

# Compliance Checker
python3 sdk-python/examples/compliance_check_example.py

# Real-Time Streaming
python3 sdk-python/examples/realtime_streaming_demo.py
```

---

## 📊 Status

### **Phase 1: Market Shockwave** ✅ COMPLETE
- Multi-Model AI ✅
- Bias Detection ✅
- Fairness Metrics ✅
- Real-Time Dashboard ✅
- Compliance Automation ✅

### **Phase 2: Enterprise Features** 📋 Planned
- HSM Integration (AWS KMS, Azure, GCP)
- Advanced AI (LIME/SHAP)
- White-label Dashboard

---

## 🤝 Support

- **Documentation:** See `docs/` folder
- **API Docs:** http://localhost:8000/docs
- **Issues:** Contact support

---

## 📄 License

Proprietary - VeriChain™ 2025

---

**VeriChain™ - The Future of AI Accountability** 🚀