eclypse 0.8.2
an Edge-CLoud pYthon Platform for Simulated runtime Environments
Requires Python: <3.14,>=3.11

<p align="center">
<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/eclypse-org/eclypse/refs/heads/main/docs/_static/images/dark.png?"><img width=450 alt="eclypse-logo" src="https://raw.githubusercontent.com/eclypse-org/eclypse/refs/heads/main/docs/_static/images/light.png"/>
</picture>
</p>

![PyPI - Version](https://img.shields.io/pypi/v/eclypse)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/eclypse)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&)](https://github.com/pre-commit/pre-commit)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
[![Checked with pylint](https://img.shields.io/badge/pylint-10/10-green)](https://pylint.pycqa.org/en/latest/)
[![Import sorted with isort](https://img.shields.io/badge/isort-checked-brightgreen)](https://pycqa.github.io/isort/)
[![Import cleaned with pycln](https://img.shields.io/badge/pycln-checked-brightgreen)](https://github.com/hadialqattan/pycln)
[![Code style: black](https://img.shields.io/badge/code%20style-black-black)](https://github.com/psf/black)
[![Doc style: docformatter](https://img.shields.io/badge/doc%20style-docformatter-black)](https://github.com/PyCQA/docformatter)

**ECLYPSE** (**E**dge-**CL**oud p**Y**thon **P**latform for **S**imulated runtime **E**nvironments) is the first simulation library entirely written in Python, for experimenting with deployment strategies in varying infrastructure conditions. It provides an interface to simulate deployments of service-based applications onto life-like infrastructures, without and with an actual application implementation to be deployed.

## Installation

To install ECLYPSE and all its dependencies, you can run the following commands:
```bash

pip install eclypse

```

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

## Documentation

The documentation for ECLYPSE can be found [here](https://eclypse.readthedocs.io/en/latest/).

## Publication

ECLYPSE is described and assessed in:

> Jacopo Massa, Valerio De Caro, Stefano Forti, Patrizio Dazzi, Davide Bacciu, Antonio Brogi<br>
> [**ECLYPSE: a Python Framework for Simulation and Emulation of the Cloud-Edge Continuum**](https://doi.org/10.1002/smr.70081), <br>
> Journal of Software: Evolution and Process, 2026.

If you want to cite ECLYPSE in your work, you can use the following BibTeX entry:
```bibtex
@article{massa2025eclypse,
  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},
}
```

## Authors

- **Jacopo Massa**
    - Website: [https://pages.di.unipi.it/massa](https://pages.di.unipi.it/massa)
    - GitHub: [jacopo-massa](https://github.com/jacopo-massa)
- **Valerio De Caro**
    - Website: [https://vdecaro.github.io](https://vdecaro.github.io)
    - GitHub: [vdecaro](https://github.com/vdecaro)

## Contact Us
If you want to get in touch with us, [drop us an e-mail](mailto:jacopo.massa@di.unipi.it,valerio.decaro@di.unipi.it?subject=[ECLYPSE]%20Request%20for%20information)!