FedModelKit 0.6.8__tar.gz → 0.8.0__tar.gz

fedmodelkit-0.8.0/.python-version

@@ -0,0 +1 @@
+3.12.7

fedmodelkit-0.8.0/LICENSE

@@ -0,0 +1,131 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

fedmodelkit-0.8.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: FedModelKit
+Version: 0.8.0
+Summary: Tools to scaffold and run privacy-preserving federated learning experiments across distributed data sites.
+Author-email: ceresale <alessandro.ceresi@upm.es>
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: flwr-datasets>=0.5.0
+Requires-Dist: flwr[simulation]>=1.17.0
+Requires-Dist: mlflow>=3.10.1
+Requires-Dist: pandas>=2.3.0
+Provides-Extra: edge
+Description-Content-Type: text/markdown
+
+# 🌐 FedModelKit (fmk)
+
+**FedModelKit** is a Python library designed to streamline the execution of **federated learning tasks** within a network of collaborating partners.  
+It provides a guided workflow that helps users quickly set up experiments, manage dependencies, and follow step-by-step instructions through generated resources.
+
+---
+
+## 📑 Table of Contents
+- [Overview](#-overview)
+- [Features](#-features)
+- [Dependencies](#-Dependencies)
+- [Installation](#-installation)
+- [Quick Start](#-quick-start)
+- [Next Steps](#-next-steps)
+- [License & Commercial Use](#-license--commercial-use)
+
+---
+
+## 🔎 Overview
+
+Federated learning enables multiple partners to train machine learning models collaboratively **without sharing raw data**.  
+The **FedModelKit** library simplifies this process by:
+
+- Automating project initialization  
+- Creating a reproducible experiment directory with all required dependencies
+- Offering a clear, step-by-step workflow to run experiments in a federated network    
+
+---
+
+## 🧩 Dependencies
+
+These are the dependencies of the packages, including the required Python version:
+
+| Dependency        | Version     | Description                                      |
+|-------------------|------------|--------------------------------------------------|
+| **Python**        | >=3.12        | Required Python interpreter version              |
+| `flwr[simulations]` | ==1.17.0  | Federated learning framework and simulations with Flower |
+| `flwr_datasets`   | >=0.5.0     | Datasets compatible with Flower                  |
+| `mlflow`          | >=3.1.1     | For experiment tracking and logging              |
+| `pandas`          | >=2.3.0     | Data manipulation and analysis                   |
+
+
+---
+
+## ⚙️ Installation
+
+It is recommended to install `FedModelKit` inside a virtual environment.  
+We suggest using [uv](https://github.com/astral-sh/uv) for fast and reproducible setups:
+
+
+1. Create and activate a virtual environment
+    ```bash
+    uv venv
+    source .venv/bin/activate
+    ```
+    or in case of Windows OS
+    ```bash
+    uv venv
+    .venv\Scripts\activate
+    ```
+
+2. Install `FedModelKit`
+    ```bash
+    uv pip install FedModelKit
+
+    ```
+
+## 🚀 Quick Start
+
+Initialize a new federated learning experiment with:
+
+```bash
+fmk init -n my_experiment
+
+```
+This will generate in the present directory the project for a new FL experiment.
+
+## 📖 Next Steps
+
+👉 Once the experiment directory has been created, open the file `README.md` that has been generated in your directory and follow the guided workflow to set up and run your federated learning tasks.
+
+---
+---
+
+## ⚖️ License & Commercial Use
+
+This software is **Source Available** and distributed under a **Dual Licensing** model.
+
+### 🎓 Non-Commercial Use (Community)
+This project is free for personal use, education, non-profit organizations, and academic research under the **PolyForm Noncommercial License 1.0.0**.
+
+* ✅ You can read, modify, and execute the code.
+* ✅ You can use it for personal and research projects.
+* ❌ You may **NOT** use it for commercial purposes or in business environments without a commercial license.
+
+Check the [LICENSE](LICENSE) file for full terms.
+
+### 💼 Commercial Use (Businesses)
+If you wish to use this software in a commercial product, a business, or any revenue-generating environment, **you must purchase a Commercial License**.
+
+The Commercial License grants you:
+* The right to use the software in commercial production environments.
+* Exemption from the PolyForm license restrictions.
+* Priority support (optional).
+
+📩 **To purchase a license, please contact us at:** federico.alvarez@upm.es

fedmodelkit-0.8.0/README.md

@@ -0,0 +1,106 @@
+# 🌐 FedModelKit (fmk)
+
+**FedModelKit** is a Python library designed to streamline the execution of **federated learning tasks** within a network of collaborating partners.  
+It provides a guided workflow that helps users quickly set up experiments, manage dependencies, and follow step-by-step instructions through generated resources.
+
+---
+
+## 📑 Table of Contents
+- [Overview](#-overview)
+- [Features](#-features)
+- [Dependencies](#-Dependencies)
+- [Installation](#-installation)
+- [Quick Start](#-quick-start)
+- [Next Steps](#-next-steps)
+- [License & Commercial Use](#-license--commercial-use)
+
+---
+
+## 🔎 Overview
+
+Federated learning enables multiple partners to train machine learning models collaboratively **without sharing raw data**.  
+The **FedModelKit** library simplifies this process by:
+
+- Automating project initialization  
+- Creating a reproducible experiment directory with all required dependencies
+- Offering a clear, step-by-step workflow to run experiments in a federated network    
+
+---
+
+## 🧩 Dependencies
+
+These are the dependencies of the packages, including the required Python version:
+
+| Dependency        | Version     | Description                                      |
+|-------------------|------------|--------------------------------------------------|
+| **Python**        | >=3.12        | Required Python interpreter version              |
+| `flwr[simulations]` | ==1.17.0  | Federated learning framework and simulations with Flower |
+| `flwr_datasets`   | >=0.5.0     | Datasets compatible with Flower                  |
+| `mlflow`          | >=3.1.1     | For experiment tracking and logging              |
+| `pandas`          | >=2.3.0     | Data manipulation and analysis                   |
+
+
+---
+
+## ⚙️ Installation
+
+It is recommended to install `FedModelKit` inside a virtual environment.  
+We suggest using [uv](https://github.com/astral-sh/uv) for fast and reproducible setups:
+
+
+1. Create and activate a virtual environment
+    ```bash
+    uv venv
+    source .venv/bin/activate
+    ```
+    or in case of Windows OS
+    ```bash
+    uv venv
+    .venv\Scripts\activate
+    ```
+
+2. Install `FedModelKit`
+    ```bash
+    uv pip install FedModelKit
+
+    ```
+
+## 🚀 Quick Start
+
+Initialize a new federated learning experiment with:
+
+```bash
+fmk init -n my_experiment
+
+```
+This will generate in the present directory the project for a new FL experiment.
+
+## 📖 Next Steps
+
+👉 Once the experiment directory has been created, open the file `README.md` that has been generated in your directory and follow the guided workflow to set up and run your federated learning tasks.
+
+---
+---
+
+## ⚖️ License & Commercial Use
+
+This software is **Source Available** and distributed under a **Dual Licensing** model.
+
+### 🎓 Non-Commercial Use (Community)
+This project is free for personal use, education, non-profit organizations, and academic research under the **PolyForm Noncommercial License 1.0.0**.
+
+* ✅ You can read, modify, and execute the code.
+* ✅ You can use it for personal and research projects.
+* ❌ You may **NOT** use it for commercial purposes or in business environments without a commercial license.
+
+Check the [LICENSE](LICENSE) file for full terms.
+
+### 💼 Commercial Use (Businesses)
+If you wish to use this software in a commercial product, a business, or any revenue-generating environment, **you must purchase a Commercial License**.
+
+The Commercial License grants you:
+* The right to use the software in commercial production environments.
+* Exemption from the PolyForm license restrictions.
+* Priority support (optional).
+
+📩 **To purchase a license, please contact us at:** federico.alvarez@upm.es

fedmodelkit-0.8.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "FedModelKit"
+version = "0.8.0"
+description = "Tools to scaffold and run privacy-preserving federated learning experiments across distributed data sites."
+readme = "README.md"
+authors = [
+    { name = "ceresale", email = "alessandro.ceresi@upm.es" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "flwr-datasets>=0.5.0",
+    "flwr[simulation]>=1.17.0",
+    "pandas>=2.3.0",
+    "mlflow>=3.10.1",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project.scripts]
+fmk = "FedModelKit.cli:main"
+
+[project.optional-dependencies]
+edge = [
+]

fedmodelkit-0.8.0/src/FedModelKit/README.md

@@ -0,0 +1,19 @@
+### **Interface Directory**
+
+1. **`aggregator.py`**
+    - This file defines the `AggProtocol` protocols. The `AggProtocol` defines the methods and attributes that an aggregator must implement.
+
+2. **`local_learner.py`**
+    - This file defines the `LLProtocol` protocols. The `LLProtocol` defines the methods and attributes that a local learner must implement. This file provides the structure for implementing custom local learners.
+
+3. **`cli.py`**
+    - This file contains the `create_structure` function, which sets up the project structure for launching a FL task. It creates necessary directories and files for the workflow.
+
+4. **`__init__.py`**
+    - This script exposes the main components of the FedModelKit package for easy import.
+
+5. **`templates/`**
+    - This folder contains template scripts for generating the content of the generated directory.
+
+6. **`mlflow_service/`**
+    - This folder contains scripts that define services for model and training registry in a Mlflow server.

fedmodelkit-0.8.0/src/FedModelKit/__init__.py

@@ -0,0 +1,24 @@
+#
+# Copyright (c) 2026 Grupo de Aplicación de Telecomunicaciones Visuales (GATV), Escuela Técnica Superior de Ingenieros de Telecomunicación, Universidad Politécnica de Madrid
+#
+# This file is part of Federated Data Fabric.
+#
+# Federated Data Fabric is licensed under the PolyForm Noncommercial License 1.0.0.
+#
+# Use of this software is permitted exclusively for NON-COMMERCIAL purposes.
+# For commercial use, please contact federico.alvarez@upm.es to obtain a commercial license.
+#
+# SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+#
+# You can view the full license text at:
+# https://polyformproject.org/licenses/noncommercial/1.0.0/
+#
+from .local_learner import LLProtocol
+from .aggregator import AggProtocol
+from .cli import create_structure
+import flwr
+
+__all__ = ["LLProtocol",
+           "AggProtocol",
+           "create_structure",
+           "flwr"]

{fedmodelkit-0.6.8 → fedmodelkit-0.8.0}/src/FedModelKit/aggregator.py

@@ -1,3 +1,18 @@
+#
+# Copyright (c) 2026 Grupo de Aplicación de Telecomunicaciones Visuales (GATV), Escuela Técnica Superior de Ingenieros de Telecomunicación, Universidad Politécnica de Madrid
+#
+# This file is part of Federated Data Fabric.
+#
+# Federated Data Fabric is licensed under the PolyForm Noncommercial License 1.0.0.
+#
+# Use of this software is permitted exclusively for NON-COMMERCIAL purposes.
+# For commercial use, please contact federico.alvarez@upm.es to obtain a commercial license.
+#
+# SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+#
+# You can view the full license text at:
+# https://polyformproject.org/licenses/noncommercial/1.0.0/
+#
 import flwr
 from typing import Protocol, runtime_checkable
 from typing import Protocol, Optional
@@ -29,13 +44,3 @@ class AggProtocol(Protocol):
         """
         ...
 
-@runtime_checkable
-class AggFactoryProtocol(Protocol):
-    '''
-    Protocol for the function creating the aggregator instance
-    '''
-    def __call__(self) -> AggProtocol:
-        """
-        Creates and returns an instance of a class conforming to AggProtocol.
-        """
-        ...

{fedmodelkit-0.6.8 → fedmodelkit-0.8.0}/src/FedModelKit/cli.py

@@ -1,16 +1,32 @@
+#
+# Copyright (c) 2026 Grupo de Aplicación de Telecomunicaciones Visuales (GATV), Escuela Técnica Superior de Ingenieros de Telecomunicación, Universidad Politécnica de Madrid
+#
+# This file is part of Federated Data Fabric.
+#
+# Federated Data Fabric is licensed under the PolyForm Noncommercial License 1.0.0.
+#
+# Use of this software is permitted exclusively for NON-COMMERCIAL purposes.
+# For commercial use, please contact federico.alvarez@upm.es to obtain a commercial license.
+#
+# SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+#
+# You can view the full license text at:
+# https://polyformproject.org/licenses/noncommercial/1.0.0/
+#
 import os
 import sys
 import argparse
 from .templates import (
-    get_main_template,
-    get_task_template,
-    get_readme_template,
-    get_server_template,
-    get_client_template,
-    get_pyproject_template,
-    get_extern_pyproject_template,
-    get_init_template,
-    get_ds_template,
+    get_task,
+    get_readme,
+    get_server,
+    get_client,
+    get_pyproject,
+    get_extern_pyproject,
+    get_init,
+    get_ds,
+    get_do1,
+    get_do2,
     get_images,
 )
 
@@ -19,18 +35,19 @@ def create_structure(exp_name: str = "new_experiment") -> None:
 
     structure = {
         f"{exp_name}": {
-            "main.py": get_main_template(),
-            "pyproject.toml": get_pyproject_template(exp_name),
+            "pyproject.toml": get_pyproject(exp_name),
             f"{exp_name}": {
-                "__init__.py": get_init_template(),
-                "task.py": get_task_template(),
-                "server_app.py": get_server_template(exp_name),
-                "client_app.py": get_client_template(exp_name),                
+                "__init__.py": get_init(),
+                "task.py": get_task(),
+                "server_app.py": get_server(exp_name),
+                "client_app.py": get_client(exp_name),                
             },
         },
-        "pyproject.toml": get_extern_pyproject_template(exp_name),
-        "README.md": get_readme_template(),
-        "ds.ipynb": get_ds_template(exp_name),
+        "pyproject.toml": get_extern_pyproject(exp_name),
+        "README.md": get_readme(),
+        "ds.ipynb": get_ds(exp_name),
+        "do1.ipynb": get_do1(exp_name),
+        "do2.ipynb": get_do2(exp_name),
     }
 
 

{fedmodelkit-0.6.8 → fedmodelkit-0.8.0}/src/FedModelKit/local_learner.py

@@ -1,3 +1,18 @@
+#
+# Copyright (c) 2026 Grupo de Aplicación de Telecomunicaciones Visuales (GATV), Escuela Técnica Superior de Ingenieros de Telecomunicación, Universidad Politécnica de Madrid
+#
+# This file is part of Federated Data Fabric.
+#
+# Federated Data Fabric is licensed under the PolyForm Noncommercial License 1.0.0.
+#
+# Use of this software is permitted exclusively for NON-COMMERCIAL purposes.
+# For commercial use, please contact federico.alvarez@upm.es to obtain a commercial license.
+#
+# SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+#
+# You can view the full license text at:
+# https://polyformproject.org/licenses/noncommercial/1.0.0/
+#
 from typing import Protocol, runtime_checkable
 
 import pandas as pd
@@ -49,13 +64,3 @@ class LLProtocol(Protocol):
         """
         ...
 
-@runtime_checkable
-class LLFactoryProtocol(Protocol):
-    '''
-    Protocol for the function creating the local learner instance
-    '''
-    def __call__(self) -> LLProtocol:
-            """
-            Creates and returns an instance of a class conforming to LLProtocol.
-            """
-            ...

fedmodelkit-0.8.0/src/FedModelKit/mlflow_service/__init__.py

@@ -0,0 +1,48 @@
+#
+# Copyright (c) 2026 Grupo de Aplicación de Telecomunicaciones Visuales (GATV), Escuela Técnica Superior de Ingenieros de Telecomunicación, Universidad Politécnica de Madrid
+#
+# This file is part of Federated Data Fabric.
+#
+# Federated Data Fabric is licensed under the PolyForm Noncommercial License 1.0.0.
+#
+# Use of this software is permitted exclusively for NON-COMMERCIAL purposes.
+# For commercial use, please contact federico.alvarez@upm.es to obtain a commercial license.
+#
+# SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+#
+# You can view the full license text at:
+# https://polyformproject.org/licenses/noncommercial/1.0.0/
+#
+"""
+MLflow Coordination Utilities for Federated Learning
+
+This package provides clean, consolidated MLflow coordination utilities for federated learning
+with Flower, enabling distributed logging, coordination, and monitoring that can
+be easily integrated into any federated learning project.
+"""
+
+from .messages import MLflowMessageType, MLflowCoordinationConfig, MLflowMetricsData, MLflowParamsData, MLflowRoundCompleteData, create_mlflow_coordination_message, extract_mlflow_coordination_config
+from .server import MLflowServerCoordinator, create_coordinator_from_environment
+from .client import MLflowClientLogger, MLflowClientIntegration, create_mlflow_client_integration, handle_mlflow_coordination_query, track_in_mlflow
+
+__all__ = [
+    # Message types and data structures
+    "MLflowMessageType",
+    "MLflowCoordinationConfig", 
+    "MLflowMetricsData",
+    "MLflowParamsData",
+    "MLflowRoundCompleteData",
+    "create_mlflow_coordination_message",
+    "extract_mlflow_coordination_config",
+    
+    # Server-side coordination
+    "MLflowServerCoordinator",
+    "create_coordinator_from_environment",
+    
+    # Client-side logging
+    "MLflowClientLogger",
+    "MLflowClientIntegration",
+    "create_mlflow_client_integration",
+    "handle_mlflow_coordination_query",
+    "track_in_mlflow",
+]