# P2PFL - Federated Learning over P2P networks
[](/blob/main/LICENSE.md)
[](/issues)
[](https://htmlpreview.github.io/?/blob/python-coverage-comment-action-data/htmlcov/index.html)
[](https://join.slack.com/t/p2pfl/shared_invite/zt-38xyec0k7-tLPbNx873Pm~N4aoqIyjRw)
P2PFL is a general-purpose open-source library designed for the execution (simulated and in real environments) of Decentralized Federated Learning systems, specifically making use of P2P networks and the gossip protocols.
## ✨ Key Features
P2PFL offers a range of features designed to make decentralized federated learning accessible and efficient. For detailed information, please refer to our [documentation](https://p2pfl.github.io/p2pfl/).
| Feature | Description |
|-------------------|--------------------------------------------------|
| 🚀 Easy to Use | [Get started](https://p2pfl.github.io/p2pfl/quickstart.html) quickly with our intuitive API. |
| 🛡️ Reliable | Built for fault tolerance and resilience. |
| 🌐 Scalable | Leverages the power of peer-to-peer networks. |
| 🧪 Versatile | Experiment in simulated or real-world environments.|
| 🔒 Private | Prioritizes data privacy with decentralized architecture.|
| 🧩 Flexible | Designed to be easy to modify.|
| 📈 Real-time Monitoring | Manage and track experiment through [P2PFL Web Services platform](https://p2pfl.com). |
| 🧠 ML Frameworks | Seamlessly integrate [PyTorch](https://pytorch.org/), [TensorFlow/Keras](https://www.tensorflow.org/), and [JAX](https://github.com/google/jax) models. |
| 📡 Communication Protocol Agnostic | Choose the communication protocol that best suits your needs (e.g., [gRPC](https://grpc.io/)). |
| 🔌 Integrations | Enhanced capabilities through integrations: [Hugging Face Datasets](https://huggingface.co/datasets), ML frameworks, communication protocols, and [Ray](https://www.ray.io/) for large-scale simulations. |
## 📥 Installation
### 👨🏼💻 For Users
```bash
pip install "p2pfl[torch]"
```
### 👨🏼🔧 For Developers
[](https://codespaces.new/p2pfl/p2pfl/tree/develop?quickstart=1)
#### 🐍 Python (using Poetry)
```bash
git clone https://github.com/p2pfl/p2pfl.git
cd p2pfl
poetry install -E torch
```
> **Note:** Use the extras (`-E`) flag to install specific dependencies (e.g., `-E torch`). Use `--no-dev` to exclude development dependencies.
#### 🐳 Docker
```bash
docker build -t p2pfl .
docker run -it --rm p2pfl bash
```
## 🎬 Quickstart
To start using P2PFL, follow our [quickstart guide](https://p2pfl.github.io/p2pfl/quickstart.html) in the documentation.
## 📚 Documentation & Resources
* **Documentation:** [https://p2pfl.github.io/p2pfl/](https://p2pfl.github.io/p2pfl)
* **Technical Report:** (first version) [other/memoria.pdf](other/memoria.pdf)
## 🤝 Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Please adhere to the project's code of conduct in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
## 💬 Community
Connect with us and stay updated:
* [**GitHub Issues:**](/issues) - For reporting bugs and requesting features.
* [**Google Group:**](https://groups.google.com/g/p2pfl) - For discussions and announcements.
* [**Slack:**](https://join.slack.com/t/p2pfl/shared_invite/zt-38xyec0k7-tLPbNx873Pm~N4aoqIyjRw) - For real-time conversations and support.
## ⭐ Star History
A big thank you to the community for your interest in P2PFL! We appreciate your support and contributions.
[](https://star-history.com/#p2pfl/p2pfl&Date)
## 📜 License
[GNU General Public License, Version 3.0](https://www.gnu.org/licenses/gpl-3.0.en.html)
Raw data
{
"_id": null,
"home_page": null,
"name": "p2pfl",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "federated learning, fl, peer to peer, p2p, decentralized, data privacy, data security, pytorch",
"author": "Pedro Guijas",
"author_email": "pguijas@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b4/6e/1433fc5991fd58f01b4374a5da5d44a441fcd825391f3f8fa3ed6db82259/p2pfl-0.4.3.tar.gz",
"platform": null,
"description": "\n\n# P2PFL - Federated Learning over P2P networks\n\n[](/blob/main/LICENSE.md)\n[](/issues)\n\n\n\n\n[](https://htmlpreview.github.io/?/blob/python-coverage-comment-action-data/htmlcov/index.html)\n[](https://join.slack.com/t/p2pfl/shared_invite/zt-38xyec0k7-tLPbNx873Pm~N4aoqIyjRw)\n\nP2PFL is a general-purpose open-source library designed for the execution (simulated and in real environments) of Decentralized Federated Learning systems, specifically making use of P2P networks and the gossip protocols.\n\n## \u2728 Key Features\n\nP2PFL offers a range of features designed to make decentralized federated learning accessible and efficient. For detailed information, please refer to our [documentation](https://p2pfl.github.io/p2pfl/).\n\n| Feature | Description |\n|-------------------|--------------------------------------------------|\n| \ud83d\ude80 Easy to Use | [Get started](https://p2pfl.github.io/p2pfl/quickstart.html) quickly with our intuitive API. |\n| \ud83d\udee1\ufe0f Reliable | Built for fault tolerance and resilience. |\n| \ud83c\udf10 Scalable | Leverages the power of peer-to-peer networks. |\n| \ud83e\uddea Versatile | Experiment in simulated or real-world environments.|\n| \ud83d\udd12 Private | Prioritizes data privacy with decentralized architecture.|\n| \ud83e\udde9 Flexible | Designed to be easy to modify.|\n| \ud83d\udcc8 Real-time Monitoring | Manage and track experiment through [P2PFL Web Services platform](https://p2pfl.com). |\n| \ud83e\udde0 ML Frameworks | Seamlessly integrate [PyTorch](https://pytorch.org/), [TensorFlow/Keras](https://www.tensorflow.org/), and [JAX](https://github.com/google/jax) models. |\n| \ud83d\udce1 Communication Protocol Agnostic | Choose the communication protocol that best suits your needs (e.g., [gRPC](https://grpc.io/)). |\n| \ud83d\udd0c Integrations | Enhanced capabilities through integrations: [Hugging Face Datasets](https://huggingface.co/datasets), ML frameworks, communication protocols, and [Ray](https://www.ray.io/) for large-scale simulations. |\n\n## \ud83d\udce5 Installation\n\n### \ud83d\udc68\ud83c\udffc\u200d\ud83d\udcbb For Users\n\n```bash\npip install \"p2pfl[torch]\"\n```\n\n### \ud83d\udc68\ud83c\udffc\u200d\ud83d\udd27 For Developers\n\n[](https://codespaces.new/p2pfl/p2pfl/tree/develop?quickstart=1)\n\n#### \ud83d\udc0d Python (using Poetry)\n\n```bash\ngit clone https://github.com/p2pfl/p2pfl.git\ncd p2pfl\npoetry install -E torch \n```\n\n> **Note:** Use the extras (`-E`) flag to install specific dependencies (e.g., `-E torch`). Use `--no-dev` to exclude development dependencies.\n\n#### \ud83d\udc33 Docker\n\n```bash\ndocker build -t p2pfl .\ndocker run -it --rm p2pfl bash\n```\n\n## \ud83c\udfac Quickstart\n\nTo start using P2PFL, follow our [quickstart guide](https://p2pfl.github.io/p2pfl/quickstart.html) in the documentation.\n\n## \ud83d\udcda Documentation & Resources\n\n* **Documentation:** [https://p2pfl.github.io/p2pfl/](https://p2pfl.github.io/p2pfl)\n* **Technical Report:** (first version) [other/memoria.pdf](other/memoria.pdf)\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Please adhere to the project's code of conduct in [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).\n\n## \ud83d\udcac Community\n\nConnect with us and stay updated:\n\n* [**GitHub Issues:**](/issues) - For reporting bugs and requesting features.\n* [**Google Group:**](https://groups.google.com/g/p2pfl) - For discussions and announcements.\n* [**Slack:**](https://join.slack.com/t/p2pfl/shared_invite/zt-38xyec0k7-tLPbNx873Pm~N4aoqIyjRw) - For real-time conversations and support.\n\n## \u2b50 Star History\n\nA big thank you to the community for your interest in P2PFL! We appreciate your support and contributions.\n\n[](https://star-history.com/#p2pfl/p2pfl&Date)\n\n## \ud83d\udcdc License\n\n[GNU General Public License, Version 3.0](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "A p2p federated learning framework",
"version": "0.4.3",
"project_urls": {
"Documentation": "https://p2pfl.github.io/p2pfl/",
"Homepage": "https://p2pfl.com",
"Repository": "https://github.com/p2pfl/p2pfl"
},
"split_keywords": [
"federated learning",
" fl",
" peer to peer",
" p2p",
" decentralized",
" data privacy",
" data security",
" pytorch"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "12d5fca9de3a47b6d3c4a92e8d2d37bd544dfab45ae5fa8b2ee15fcf06e3f467",
"md5": "1eb986d62bcb84b10d68a7fc1f951cce",
"sha256": "887bcf76a9acfa9b0b6cbcadd63d81c29af401df1bafbe0b9ff12c11c9edee76"
},
"downloads": -1,
"filename": "p2pfl-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1eb986d62bcb84b10d68a7fc1f951cce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 250398,
"upload_time": "2025-07-11T10:38:09",
"upload_time_iso_8601": "2025-07-11T10:38:09.083540Z",
"url": "https://files.pythonhosted.org/packages/12/d5/fca9de3a47b6d3c4a92e8d2d37bd544dfab45ae5fa8b2ee15fcf06e3f467/p2pfl-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b46e1433fc5991fd58f01b4374a5da5d44a441fcd825391f3f8fa3ed6db82259",
"md5": "4808187e43978cb578dd490f3fdeb3c5",
"sha256": "71620efe5f26c6dfe8b49ec75c528a1a887669f0c3c8a915294168663256b429"
},
"downloads": -1,
"filename": "p2pfl-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "4808187e43978cb578dd490f3fdeb3c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 130936,
"upload_time": "2025-07-11T10:38:10",
"upload_time_iso_8601": "2025-07-11T10:38:10.756813Z",
"url": "https://files.pythonhosted.org/packages/b4/6e/1433fc5991fd58f01b4374a5da5d44a441fcd825391f3f8fa3ed6db82259/p2pfl-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 10:38:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "p2pfl",
"github_project": "p2pfl",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "p2pfl"
}
JSON
