Organoid-FL

Federated Learning Platform for Organoid Image Analysis

Rust HNSW VectorDB + YOLOv11 + DINOv2 + SAM2 + PyTorch FedAvg + Streamlit Dashboard

---

🎯 What is Organoid-FL?

Organoid-FL is an end-to-end federated learning platform for medical organoid image analysis. It enables multiple hospitals/research labs to collaboratively train AI models without sharing patient data.

Multi-Task Vision Pipeline

Model	Task	Output
YOLOv11	Detection	Bounding boxes + class + confidence
DINOv2	Feature Extraction	768-dim self-supervised embeddings
SAM2	Segmentation	Pixel-level masks + morphology metrics
FedAvg	Aggregation	Privacy-preserving model updates

Key Results

Metric	Value
Classification Accuracy	99.17%
Feature Dim	768 (DINOv2 base)
Detection	YOLOv11 (3.2M–20.1M params)
Segmentation	SAM2 (pixel-level)
Vector Search	HNSW (kNN)
Audit	SHA-256 Blockchain

---

🚀 Quick Start (3 ways)

Option A: Local (no Docker)

pip install -r requirements.txt
streamlit run app.py
# Open http://localhost:8501

Option B: Docker

cp .env.example .env
docker compose up -d
# Open http://localhost:8501

Option C: Streamlit Community Cloud (Free)

1. Push to GitHub
2. Go to share.streamlit.io
3. Connect repo → deploy
4. Get https://your-app.streamlit.app

---

📊 Platform Modules (11 pages)

Page	Description
🏠 Dashboard	Platform overview, key metrics, quick actions
📁 Data Explorer	Generate/upload organoid images, data distribution
🔄 FL Training	Interactive FedAvg training with real-time charts
🎯 Detection	YOLOv11 organoid detection, counting, classification
✂️ Segmentation	SAM2 pixel-level masks, morphology analysis
🌌 Feature Space	DINOv2 t-SNE/UMAP feature visualization
🧩 Multi-Task FL	Detection + classification + segmentation jointly
🔍 Vector Search	HNSW approximate nearest neighbor search
⛓️ Audit Chain	Blockchain-style immutable operation log
📈 Model Analysis	Confusion matrix, per-client gap analysis
🔬 Research	Methodology, paper references, architecture

---

🏗️ Architecture

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Hospital A  │    │  Hospital B  │    │  Hospital C  │
│  (Local Data)│    │  (Local Data)│    │  (Local Data)│
└──────┬──────┘    └──────┬──────┘    └──────┬──────┘
       │                  │                  │
       │  YOLO + DINOv2 + SAM2 weights      │
       │  (no images shared)                 │
       └──────────────┬──────────────────────┘
                      │
              ┌───────┴───────┐
              │  FedAvg Server │
              │  Aggregation   │
              └───────┬───────┘
                      │
         ┌────────────┼────────────┐
         ▼            ▼            ▼
    ┌─────────┐ ┌─────────┐ ┌─────────┐
    │ YOLOv11 │ │ DINOv2  │ │  SAM2   │
    │ Detect  │ │ Classify│ │ Segment │
    └─────────┘ └─────────┘ └─────────┘

---

📁 Project Structure

organoid-fl/
├── app.py                    # Streamlit entry point
├── requirements.txt          # Python dependencies
├── Dockerfile                # Docker deployment
├── docker-compose.yml        # Container orchestration
├── .env.example              # Configuration template
├── src/                      # Rust VectorDB (optional backend)
│   ├── main.rs               # gRPC + HTTP server
│   ├── db.rs                 # VectorDB core
│   ├── hnsw_index.rs         # HNSW ANN search
│   ├── blockchain.rs         # SHA-256 audit chain
│   ├── grpc.rs               # gRPC service
│   └── web.rs                # REST API + dashboard
├── modules/                  # Streamlit page modules
│   ├── dashboard.py          # 🏠 Overview
│   ├── data_explorer.py      # 📁 Data management
│   ├── fl_training.py        # 🔄 FedAvg training
│   ├── detection.py          # 🎯 YOLOv11 detection
│   ├── segmentation.py       # ✂️ SAM2 segmentation
│   ├── feature_space.py      # 🌌 DINOv2 visualization
│   ├── multi_task.py         # 🧩 Multi-task FL
│   ├── vector_search.py      # 🔍 HNSW search
│   ├── audit_chain.py        # ⛓️ Audit browser
│   ├── model_analysis.py     # 📈 Performance analysis
│   └── research.py           # 🔬 Methodology
├── analysis/                 # Core analysis engines
│   ├── fl_engine.py          # FedAvg engine
│   ├── multi_task_fl.py      # Multi-task FL engine
│   ├── detector.py           # YOLOv11 detector
│   ├── feature_extractor_v2.py  # DINOv2 + ResNet18
│   ├── segmentor.py          # SAM2 segmentor
│   ├── vector_engine.py      # In-memory vector search
│   └── audit_engine.py       # SHA-256 audit chain
├── visualization/            # Plotly charts
│   └── charts.py             # All chart functions
├── data/                     # Data layer
│   └── synthetic.py          # Synthetic data generator
├── utils/                    # Utilities
│   ├── constants.py          # Config & references
│   └── helpers.py            # Helper functions
├── tests/                    # Python tests (24 passed)
│   ├── test_fl_engine.py
│   ├── test_vector_engine.py
│   └── test_audit_engine.py
├── fl/                       # Legacy CLI demo (preserved)
├── proto/                    # Protocol Buffers
└── README.md

---

🔬 Research Context

This project is part of research on privacy-preserving medical AI at XJTLU. Organoids — lab-grown mini-organs — are increasingly used in drug discovery and personalized medicine.

Multi-Task Vision Pipeline

1. YOLOv11 detects individual organoids (bounding boxes + classification)
2. DINOv2 extracts 768-dim self-supervised features (no labels needed)
3. SAM2 segments organoids at pixel level (morphology metrics)
4. FedAvg aggregates model updates across hospitals (no data sharing)
5. HNSW enables fast similarity search over feature embeddings
6. Blockchain provides tamper-evident audit trail for compliance

Key References

• McMahan et al. (2017) — FedAvg: Communication-Efficient Learning
• Li et al. (2020) — FedProx: Federated Optimization in Heterogeneous Networks
• Oquab et al. (2023) — DINOv2: Learning Robust Visual Features
• Jocher et al. (2025) — YOLOv11: Ultralytics
• Ravi et al. (2024) — SAM 2: Segment Anything in Images and Videos

---

🧪 Running Tests

# Python tests
pytest tests/ -v

# Rust tests (if Rust toolchain available)
cd src && cargo test

---

📄 License

MIT

---

Organoid-FL — Privacy-preserving multi-task AI for medical organoid analysis