FedModelKit 0.7.0__tar.gz → 0.9.3__tar.gz

fedmodelkit-0.9.3/.gitlab-ci.yml

@@ -0,0 +1,47 @@
+image: python:3.12-slim
+
+stages:
+  - check
+  - build
+  - publish
+
+variables:
+  UV_VERSION: "0.5.18"
+
+# Install uv once and reuse across jobs
+.uv-base:
+  before_script:
+    - pip install uv==$UV_VERSION
+
+check_project:
+  stage: check
+  extends: .uv-base
+  script:
+    - uv lock --check
+    - uv build --sdist
+
+build_package:
+  stage: build
+  extends: .uv-base
+  script:
+    - uv build
+  artifacts:
+    paths:
+      - dist/
+  rules:
+    - if: $CI_COMMIT_TAG
+
+publish_to_pypi:
+  stage: publish
+  extends: .uv-base
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: https://pypi.org
+  script:
+    - uv pip install --system twine
+    - TWINE_USERNAME=__token__ TWINE_PASSWORD=$PYPI_ID_TOKEN twine upload
+      --verbose dist/*
+  rules:
+    - if: $CI_COMMIT_TAG
+  dependencies:
+    - build_package

fedmodelkit-0.9.3/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.7.0 → fedmodelkit-0.9.3}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: FedModelKit
-Version: 0.7.0
+Version: 0.9.3
 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.1.1
+Requires-Dist: mlflow>=3.10.1
 Requires-Dist: pandas>=2.3.0
 Provides-Extra: edge
 Description-Content-Type: text/markdown
@@ -26,6 +26,7 @@ It provides a guided workflow that helps users quickly set up experiments, manag
 - [Installation](#-installation)
 - [Quick Start](#-quick-start)
 - [Next Steps](#-next-steps)
+- [License & Commercial Use](#-license--commercial-use)
 
 ---
 
@@ -46,7 +47,7 @@ These are the dependencies of the packages, including the required Python versio
 
 | Dependency        | Version     | Description                                      |
 |-------------------|------------|--------------------------------------------------|
-| **Python**        | >=3.13        | Required Python interpreter version              |
+| **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              |
@@ -90,4 +91,30 @@ 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.
+👉 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.7.0 → fedmodelkit-0.9.3}/README.md

@@ -12,6 +12,7 @@ It provides a guided workflow that helps users quickly set up experiments, manag
 - [Installation](#-installation)
 - [Quick Start](#-quick-start)
 - [Next Steps](#-next-steps)
+- [License & Commercial Use](#-license--commercial-use)
 
 ---
 
@@ -32,7 +33,7 @@ These are the dependencies of the packages, including the required Python versio
 
 | Dependency        | Version     | Description                                      |
 |-------------------|------------|--------------------------------------------------|
-| **Python**        | >=3.13        | Required Python interpreter version              |
+| **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              |
@@ -76,4 +77,30 @@ 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.
+👉 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.7.0 → fedmodelkit-0.9.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "FedModelKit"
-version = "0.7.0"
+version = "0.9.3"
 description = "Tools to scaffold and run privacy-preserving federated learning experiments across distributed data sites."
 readme = "README.md"
 authors = [
@@ -11,7 +11,7 @@ dependencies = [
     "flwr-datasets>=0.5.0",
     "flwr[simulation]>=1.17.0",
     "pandas>=2.3.0",
-    "mlflow>=3.1.1",
+    "mlflow>=3.10.1",
 ]
 
 [build-system]

fedmodelkit-0.9.3/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.7.0 → fedmodelkit-0.9.3}/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

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/cli.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 os
 import sys
 import argparse
@@ -21,6 +36,7 @@ def create_structure(exp_name: str = "new_experiment") -> None:
     structure = {
         f"{exp_name}": {
             "pyproject.toml": get_pyproject(exp_name),
+            ".python-version": "3.12",
             f"{exp_name}": {
                 "__init__.py": get_init(),
                 "task.py": get_task(),

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/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

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/mlflow_service/__init__.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/
+#
 """
 MLflow Coordination Utilities for Federated Learning
 

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/mlflow_service/client.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/
+#
 """
 MLflow Client-side Logging for Federated Learning.
 
@@ -558,6 +573,7 @@ def handle_mlflow_coordination_query(msg: Message, ctx: Context, integration: ML
     
     # Handle MLflow coordination
     if integration.handle_mlflow_coordination(msg):
+        print("📡 Handled MLflow coordination message")
         logger.info("MLflow coordination handled successfully")
         return Message(RecordDict(), reply_to=msg)
     else:

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/mlflow_service/messages.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/
+#
 """
 Custom Flower messages for MLflow coordination in federated learning.
 

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/mlflow_service/server.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/
+#
 """
 MLflow Server-side Coordination for Federated Learning.
 
@@ -261,7 +276,7 @@ class MLflowServerCoordinator:
                 
                 coordination_message = Message(
                     content=recordset,
-                    message_type=MessageType.QUERY,
+                    message_type="query.mlflow_coordination",
                     dst_node_id=node_id,
                     group_id="mlflow_coordination",
                     ttl=DEFAULT_TTL,

{fedmodelkit-0.7.0 → fedmodelkit-0.9.3}/src/FedModelKit/templates/client_app.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 Iterator
 import numpy as np
 import pandas as pd
@@ -28,6 +43,7 @@ def mlflow_coordination_query(msg: Message, ctx: Context) -> Message:
     Named query function specifically for MLflow coordination.
     This function uses the reusable integration component.
     """
+
     return handle_mlflow_coordination_query(msg, ctx, mlflow_integration)
 
 @app.query()
@@ -37,10 +53,6 @@ def query(msg: Message, ctx: Context) -> Message:
     initial configuration sent by the server.
     """
 
-    if mlflow_integration.handle_mlflow_coordination(msg):
-        print("📡 Handled MLflow coordination message")
-        return Message(RecordDict(), reply_to=msg)
-
     # Check if this message contains regular configuration data
     if (hasattr(msg.content, 'config_records') and 
         'fancy_config' in msg.content.config_records):