Spaces:
Running
Running
File size: 4,032 Bytes
2a95347 94769b3 2a95347 94769b3 2a95347 94769b3 2a95347 94769b3 2a95347 94769b3 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 | ---
title: Next Federation
emoji: 🛰️
colorFrom: green
colorTo: gray
sdk: static
app_file: index.html
pinned: false
license: cc-by-4.0
short_description: Federated learning across simulated clients
---
# Next Federation
Next Federation trains one digit classifier across **10 clients whose data are distributed differently**
(Dirichlet label skew) and who sometimes **drop out**. It compares FedAvg, FedProx and local-only training on global
accuracy, the **worst client's** accuracy on its own data, and communication traffic.
**This is a simulation: all clients run in one process; nothing was deployed to real devices.**
**Model:** https://huggingface.co/thelamapi/Next-Federation — change skew, dropout, clients and rounds; all three methods retrain in the browser.
## Results (5 seeds per setting, 40 rounds, 2 local epochs, lr 0.3, FedProx μ 0.01)
| Setting | Method | Global test accuracy | Worst client | Mean client | Traffic (MB) |
|---|---|---:|---:|---:|---:|
| alpha=0.1, dropout=0.0 | FedAvg | 0.934 ± 0.011 | 0.784 ± 0.100 | 0.940 | 7.7 |
| alpha=0.1, dropout=0.0 | FedProx | 0.934 ± 0.011 | 0.784 ± 0.100 | 0.940 | 7.7 |
| alpha=0.1, dropout=0.0 | Local only | 0.357 ± 0.011 | 0.448 ± 0.391 | 0.920 | 0.0 |
| alpha=0.1, dropout=0.3 | FedAvg | 0.928 ± 0.019 | 0.776 ± 0.090 | 0.934 | 6.5 |
| alpha=0.1, dropout=0.3 | FedProx | 0.929 ± 0.018 | 0.769 ± 0.090 | 0.932 | 6.5 |
| alpha=0.1, dropout=0.3 | Local only | 0.357 ± 0.011 | 0.448 ± 0.391 | 0.920 | 0.0 |
| alpha=0.5, dropout=0.0 | FedAvg | 0.953 ± 0.004 | 0.866 ± 0.031 | 0.947 | 7.7 |
| alpha=0.5, dropout=0.0 | FedProx | 0.952 ± 0.003 | 0.866 ± 0.031 | 0.948 | 7.7 |
| alpha=0.5, dropout=0.0 | Local only | 0.657 ± 0.019 | 0.674 ± 0.092 | 0.881 | 0.0 |
| alpha=0.5, dropout=0.3 | FedAvg | 0.952 ± 0.005 | 0.860 ± 0.025 | 0.949 | 6.5 |
| alpha=0.5, dropout=0.3 | FedProx | 0.952 ± 0.006 | 0.860 ± 0.025 | 0.949 | 6.5 |
| alpha=0.5, dropout=0.3 | Local only | 0.657 ± 0.019 | 0.674 ± 0.092 | 0.881 | 0.0 |
| alpha=5.0, dropout=0.0 | FedAvg | 0.961 ± 0.004 | 0.880 ± 0.013 | 0.956 | 7.7 |
| alpha=5.0, dropout=0.0 | FedProx | 0.960 ± 0.005 | 0.880 ± 0.013 | 0.955 | 7.7 |
| alpha=5.0, dropout=0.0 | Local only | 0.871 ± 0.006 | 0.755 ± 0.074 | 0.883 | 0.0 |
| alpha=5.0, dropout=0.3 | FedAvg | 0.960 ± 0.005 | 0.890 ± 0.013 | 0.955 | 6.5 |
| alpha=5.0, dropout=0.3 | FedProx | 0.959 ± 0.005 | 0.890 ± 0.013 | 0.955 | 6.5 |
| alpha=5.0, dropout=0.3 | Local only | 0.871 ± 0.006 | 0.755 ± 0.074 | 0.883 | 0.0 |
Global test set: 360 digits never used for training or tuning. "Worst client" is the lowest accuracy over
clients on their own held-out 20%. Local-only global accuracy is the mean of the 10 client models.
Traffic counts float32 model downloads to every client every round plus uploads that arrive.

## Method
* Model: MLP 64→32→10 with ReLU, softmax cross-entropy, minibatch SGD (batch 20).
* FedAvg: sample-weighted average of the updates that arrive. FedProx adds (μ/2)‖w − w_global‖² to every local step.
* Dropout: a client's update is lost with probability p (its download still counts).
* lr and μ were chosen on a separate validation set with development seeds 100–101 (lr scores {0.05: 0.9027777777777778, 0.1: 0.9361111111111111, 0.3: 0.9527777777777777}, μ scores {0.01: 0.9527777777777777, 0.1: 0.95, 1.0: 0.9333333333333333}).
* The Space runs a line-by-line JavaScript port; Node parity on 4 fixed runs: max abs difference 0.
* Released weights (`model.json`): FedProx global model from α=0.5, dropout 0.3, seed 0.
## Usage
```python
from inference import load, predict
spec = load()
probs = predict(spec, pixels) # pixels: (N, 64) ints 0..16
```
## Limitations
* Simulated clients on a small, clean dataset; real federations have system heterogeneity, stragglers and privacy mechanisms (none here).
* Dropout is independent per client and round; real outages are correlated.
* Recorded on NVIDIA L4. The numbers describe this simulation only.
|