fedclypse

fedclypse is Federated Learning as a framework-agnostic verticalization of ECLYPSE. It turns an eclypse Simulation into a federation: FL participants are eclypse Service entities, the FL round is composable mechanics (selection × synchronization × aggregation × optimization) layered on top of eclypse's message passing, and a run is driven and observed the same way any eclypse experiment is. The exchange currency is plain numpy, so the base install trains real models with nothing but numpy — bring your own framework by subclassing fedclypse.core.Model and overriding Learner.local_update.

Installation

To install fedclypse and all its dependencies, you can run the following command:

pip install fedclypse

N.B. We strongly suggest the installation of fedclypse in a virtual environment.

Documentation

The documentation for fedclypse can be found here.

Citation

fedclypse is built on top of ECLYPSE. If you use it in your work or research, please cite this repository (see CITATION.cff) and the ECLYPSE framework:

@article{massa2026eclypse,
  title     = {{ECLYPSE: A Python Framework for Simulation and Emulation of the Cloud-Edge Continuum}},
  author    = {Massa, Jacopo and De Caro, Valerio and Forti, Stefano and Dazzi, Patrizio and Bacciu, Davide and Brogi, Antonio},
  journal   = {Journal of Software: Evolution and Process},
  volume    = {38},
  number    = {1},
  pages     = {e70081},
  year      = {2026},
  month     = {1},
  doi       = {10.1002/smr.70081},
}

Maintainers

fedclypse is maintained by Valerio De Caro.

Contact Us

If you want to get in touch with us, drop us an e-mail!