How manas1329/federated-learning works
The repository combines a federated chest-X-ray training system with a healthcare operations platform. The main workflow splits data across hospitals, trains private and quantized client models, coordinates rounds at the FL server, and supports evaluation and monitoring. The web platform provides authenticated admin and hospital workflows, process control, persistence, audit, and live dashboards. Several product modules are named in the README or SOURCE INDEX but were not excerpted; their relationships are shown only where documented or referenced by sampled source.
Main entry points: server.py FL coordinator · main.py Platform API · client.py FL client · trust_manager.py Trust management
Components 26
Data and modeling
- Non-IID splitter
federated_healthcare/split_data.py - Hospital datasets
- Chest CNN
federated_healthcare/src/model.py
Federated training
- FL client
federated_healthcare/src/client.py - INT8 quantization
federated_healthcare/src/quantization.py - FL coordinator
federated_healthcare/src/server.py - Dropout handling
federated_healthcare/src/dropout_handler.py - Trust management
federated_healthcare/src/trust_manager.py - Pre-aggregation gate
federated_healthcare/src/pre_agg_gate.py - Unlearning workflow
federated_healthcare/src/unlearn_workflow.py
Healthcare platform
- Platform API
webapp/main.py - Admin workflows
webapp/routes/admin_routes.py - Hospital workflows
webapp/routes/hospital_routes.py - Process manager
webapp/core/process_manager.py - Authentication and roles
webapp/core/dependencies.py - Audit logger
webapp/core/audit.py - Platform records
webapp/models/db_models.py - Database connection
webapp/database/connection.py
Monitoring and analysis
- Global evaluation
federated_healthcare/src/evaluate.py - Dashboard state API
federated_healthcare/src/dashboard_api.py - Dashboard state
federated_healthcare/src/dashboard_state.py - Operations dashboard
server-dashboard/src/App.jsx - Live-state hook
server-dashboard/src/hooks/useLiveState.js - Metrics reader
webapp/core/metrics_reader.py - Training analysis
federated_healthcare/src/graph.py
Other components
- Hospital operator
Connections 31
- Hospital operator → Non-IID splitter: prepares data
- Non-IID splitter → Hospital datasets: creates splits
- Hospital operator → FL client: starts training
- FL client → Chest CNN: trains locally
federated_healthcare/src/client.py - FL client → INT8 quantization: quantizes updates
federated_healthcare/src/client.py - FL client → FL coordinator: sends updates
- FL coordinator → Chest CNN: coordinates model
federated_healthcare/src/server.py - FL coordinator → INT8 quantization: uses quantization
federated_healthcare/src/server.py - FL coordinator → Dropout handling: handles dropout
federated_healthcare/src/server.py - FL coordinator → Trust management: checks trust
federated_healthcare/src/server.py - Trust management → Pre-aggregation gate: uses gate
federated_healthcare/src/trust_manager.py - Trust management → Dashboard state: updates state
federated_healthcare/src/trust_manager.py - FL coordinator → Unlearning workflow: invokes workflow
federated_healthcare/src/server.py - Hospital operator → Platform API: uses platform
webapp/main.py - Platform API → Admin workflows: routes requests
webapp/main.py - Platform API → Hospital workflows: routes requests
webapp/main.py - Admin workflows → Process manager: controls processes
webapp/routes/admin_routes.py - Hospital workflows → Process manager: controls processes
webapp/routes/hospital_routes.py - Admin workflows → Audit logger: records actions
webapp/routes/admin_routes.py - Hospital workflows → Audit logger: records activity
webapp/routes/hospital_routes.py - Platform API → Authentication and roles: serves routes
webapp/main.py - Authentication and roles → Platform records: queries users
webapp/core/dependencies.py - Audit logger → Platform records: creates audit records
webapp/core/audit.py - Platform records → Database connection: uses database base
webapp/models/db_models.py - Platform API → Database connection: initializes database
webapp/main.py - Operations dashboard → Live-state hook: uses live state
server-dashboard/src/App.jsx - Hospital operator → Operations dashboard: monitors training
- Hospital operator → Global evaluation: evaluates model
- Hospital operator → Training analysis: generates graphs
- Hospital operator → Dashboard state API: views live status
- Platform API → Metrics reader: reads metrics