Skip to content

init/paper joss #211

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 41 commits into from
Jul 1, 2025
Merged
Show file tree
Hide file tree
Changes from 40 commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
fc9be9e
init and add current references
AHReccese Jun 3, 2025
31a21eb
init `paper.md`
AHReccese Jun 3, 2025
3386b89
add `Summary` section
AHReccese Jun 3, 2025
c97f2ac
add `Statement of Need` section
AHReccese Jun 3, 2025
3c71214
add comparison table (`sepand` feedback)
AHReccese Jun 3, 2025
0df104e
`CHANGELOG.md` updated
AHReccese Jun 3, 2025
67b3978
Merge branch 'dev' of https://github.com/openscilab/pymilo into init/…
AHReccese Jun 4, 2025
170d624
add my ORCID id, add TODO for placeholder for the others
AHReccese Jun 4, 2025
6cfaa7d
finalize `orcid`s
AHReccese Jun 11, 2025
05195c2
update summary
AHReccese Jun 11, 2025
0570fe2
`CHANGELOG.md` updated
AHReccese Jun 11, 2025
7b50a36
rewrite `pickle` and `joblib` sections
AHReccese Jun 11, 2025
d052a25
rewrite `PMML and ONNX` sections
AHReccese Jun 11, 2025
464756a
rewrite and summarize `SKOPS, Tensorflow.js` sections
AHReccese Jun 11, 2025
4e72726
make the wrap up part concise
AHReccese Jun 11, 2025
69c541a
drop duplicated ref
AHReccese Jun 11, 2025
4978725
update ref
AHReccese Jun 11, 2025
ce7530c
summarize the last paragraph introducing PyMilo
AHReccese Jun 11, 2025
35dc50f
multi-lining the text
AHReccese Jun 11, 2025
917c961
applying feedback
AHReccese Jun 13, 2025
03a87b5
drop the python tag
AHReccese Jun 16, 2025
3024c55
apply some textual feedback
AHReccese Jun 16, 2025
cf0b42d
referencing Table according to JOSS documentation
AHReccese Jun 16, 2025
9ffb61a
update table defining and referring based on `https://github.com/RECe…
AHReccese Jun 16, 2025
129765a
increase the cohesiveness
AHReccese Jun 16, 2025
5a35090
apply feedback
AHReccese Jun 16, 2025
3e3a8a6
add overall pymilo image
AHReccese Jun 16, 2025
68d459a
add overall figure - following the way it is done in `https://joss.th…
AHReccese Jun 16, 2025
db1c57e
rename file to `pymilo_outlook.png`
AHReccese Jun 18, 2025
af389a3
update image caption
AHReccese Jun 18, 2025
e77f5d3
add more refs
alirezazolanvari Jun 23, 2025
ec4182a
`refs` final update by Amir
AHReccese Jun 24, 2025
f39d4cb
sycn and enhance paper content with the refs changes (+updates)
AHReccese Jun 24, 2025
b254022
Update paper.md
AHReccese Jun 25, 2025
2ec1fc5
add : Sadra's 2nd affiliation added.
sadrasabouri Jun 26, 2025
9d7c1f8
add doi for references
AHReccese Jun 26, 2025
c3eb6a5
Merge branch 'init/paper-joss' of https://github.com/openscilab/pymil…
AHReccese Jun 26, 2025
568f127
add 2nd affiliation
AHReccese Jun 26, 2025
9f8479f
add skops cite, drop cite of blog invesitgating skops
AHReccese Jun 28, 2025
e7775e8
update cite for skops
AHReccese Jun 28, 2025
0dda2e8
update `onnx` and `pmml` to `@software` citing
AHReccese Jul 1, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
156 changes: 156 additions & 0 deletions paper/paper.bib
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@
@article{Raschka2020,
author = {Sebastian Raschka and Joshua Patterson and Corey Nolet},
title = {Machine learning in Python: Main developments and technology trends in data science, machine learning, and artificial intelligence},
journal = {Information},
volume = {11},
number = {4},
pages = {193},
year = {2020},
doi = {10.3390/info11040193}
}

@inproceedings{parida2025model,
author={Parida, Shreyas Kumar and Gerostathopoulos, Ilias and Bogner, Justus},
booktitle={2025 IEEE/ACM 4th International Conference on AI Engineering – Software Engineering for AI (CAIN)},
title={How Do Model Export Formats Impact the Development of ML-Enabled Systems? A Case Study on Model Integration},
year={2025},
volume={},
number={},
pages={48-59},
doi={10.1109/CAIN66642.2025.00014}
}

@inproceedings{davis2023reusing,
title={Reusing deep learning models: Challenges and directions in software engineering},
author={Davis, James C and Jajal, Purvish and Jiang, Wenxin and Schorlemmer, Taylor R and Synovic, Nicholas and Thiruvathukal, George K},
booktitle={2023 IEEE John Vincent Atanasoff International Symposium on Modern Computing (JVA)},
pages={17--30},
year={2023},
organization={IEEE},
doi={10.1109/JVA60410.2023.00015}
}

@article{Garbin2022,
author = {Cristina Garbin and Osvaldo Marques},
title = {Assessing methods and tools to improve reporting, increase transparency, and reduce failures in machine learning applications in health care},
journal = {Radiology: Artificial Intelligence},
volume = {4},
number = {2},
pages = {e210127},
year = {2022},
doi = {10.1148/ryai.210127},
}

@article{bodimani2024assessing,
title={Assessing The Impact of Transparent AI Systems in Enhancing User Trust and Privacy},
author={Bodimani, Meghasai},
journal={Journal of Science \& Technology},
volume={5},
number={1},
pages={50--67},
year={2024},
doi={10.55662/JST.2024.5102}
}

@misc{Brownlee2018,
author = {Jason Brownlee},
title = {Save and load machine learning models in Python with scikit-learn},
howpublished = {\url{https://machinelearningmastery.com/save-load-machine-learning-models-python-scikit-learn/}},
year = {2018},
note = {Accessed: 2024-05-22}
}

@misc{PythonPickleDocs,
author = {{Python Software Foundation}},
title = {pickle — Python object serialization},
year = {2024},
howpublished = {\url{https://docs.python.org/3/library/pickle.html#security}},
}

@misc{onnx,
title={Onnx: Open neural network exchange},
author={Bai, Junjie and Lu, Fang and Zhang, Ke and others},
year={2019}
}

@article{pmml,
title={PMML: An open standard for sharing models},
author={Guazzelli, Alex and Zeller, Michael and Lin, Wen-Ching and Williams, Graham},
year={2009},
doi={10.32614/RJ-2009-010}
}

@article{jajal2023analysis,
title={Analysis of failures and risks in deep learning model converters: A case study in the onnx ecosystem},
author={Jajal, Purvish and Jiang, Wenxin and Tewari, Arav and Kocinare, Erik and Woo, Joseph and Sarraf, Anusha and Lu, Yung-Hsiang and Thiruvathukal, George K and Davis, James C},
journal={arXiv preprint arXiv:2303.17708},
year={2023},
doi={10.48550/arXiv.2303.17708}
}

@inproceedings{cody2024extending,
title={On extending the automatic test markup language (ATML) for machine learning},
author={Cody, Tyler and Li, Bingtong and Beling, Peter},
booktitle={2024 IEEE International Systems Conference (SysCon)},
pages={1--8},
year={2024},
organization={IEEE},
doi={10.1109/SysCon61195.2024.10553464}
}

@misc{skops,
author = {{skops-dev}},
title = {skops: Safe and transparent model sharing},
year = {2023},
howpublished = {\url{https://github.com/skops-dev/skops}},
note = {GitHub repository. Accessed: 2025-06-28}
}

@article{tfjs2019,
title={Tensorflow. js: Machine learning for the web and beyond},
author={Smilkov, Daniel and Thorat, Nikhil and Assogba, Yannick and Nicholson, Charles and Kreeger, Nick and Yu, Ping and Cai, Shanqing and Nielsen, Eric and Soegel, David and Bileschi, Stan and others},
journal={Proceedings of Machine Learning and Systems},
volume={1},
pages={309--321},
year={2019},
doi={10.48550/arXiv.1901.05350}
}

@inproceedings{quan2022towards,
title={Towards understanding the faults of javascript-based deep learning systems},
author={Quan, Lili and Guo, Qianyu and Xie, Xiaofei and Chen, Sen and Li, Xiaohong and Liu, Yang},
booktitle={Proceedings of the 37th IEEE/ACM International Conference on Automated Software Engineering},
pages={1--13},
year={2022},
doi={10.1145/3551349.3560427}
}

@misc{NerdCorner2025,
author = {{Nerd Corner}},
title = {TensorFlow.js vs TensorFlow (Python) -- Pros and cons},
year = {2025},
month = {Mar},
howpublished = {\url{https://nerd-corner.com/tensorflow-js-vs-tensorflow-python/}}
}

@inproceedings{rauker2023toward,
title={Toward transparent ai: A survey on interpreting the inner structures of deep neural networks},
author={R{\"a}uker, Tilman and Ho, Anson and Casper, Stephen and Hadfield-Menell, Dylan},
booktitle={2023 ieee conference on secure and trustworthy machine learning (satml)},
pages={464--483},
year={2023},
organization={IEEE},
doi={10.1109/SaTML54575.2023.00039}
}

@article{macrae2019governing,
title={Governing the safety of artificial intelligence in healthcare},
author={Macrae, Carl},
journal={BMJ quality \& safety},
volume={28},
number={6},
pages={495--498},
year={2019},
publisher={BMJ Publishing Group Ltd},
doi={10.1136/bmjqs-2019-009484}
}
98 changes: 98 additions & 0 deletions paper/paper.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
---
title: 'PyMilo: A Python Library for ML I/O'
tags:
- Machine Learning
- Model Deployment
- Model Serialization
- Transparency
- MLOPS
authors:
- name: AmirHosein Rostami
orcid: 0009-0000-0638-2263
corresponding: true
affiliation: "1, 2"
- name: Sepand Haghighi
orcid: 0000-0001-9450-2375
corresponding: false
affiliation: 1
- name: Sadra Sabouri
orcid: 0000-0003-1047-2346
corresponding: false
affiliation: "1, 3"
- name: Alireza Zolanvari
orcid: 0000-0003-2367-8343
corresponding: false
affiliation: 1
affiliations:
- index: 1
name: Open Science Lab
- index: 2
name: University of Toronto, Toronto, Canada
ror: 03dbr7087
- index: 3
name: University of Southern California, Los Angeles, United States
ror: 03taz7m60
date: 24 June 2025
bibliography: paper.bib
---

# Summary
PyMilo is an open-source Python package that addresses the limitations of existing machine learning (ML) model storage formats by providing a transparent, reliable, end-to-end, and safe method for exporting and deploying trained models.
Current tools rely on black-box or executable formats that obscure internal model structures, making them difficult to audit, verify, or safely share.
Others apply structural transformations during export that may degrade predictive performance and reduce the model to a limited inference-only interface.
In contrast, PyMilo serializes models in a transparent human-readable format that preserves end-to-end model fidelity and enables reliable, safe, and interpretable exchange.
This package is designed to make the preservation and reuse of trained ML models safer, more interpretable, and easier to manage across different stages of the ML workflow (\autoref{fig:overall}).

![PyMilo is an end-to-end, transparent, and safe solution for transporting models from machine learning frameworks to the target devices. PyMilo preserves the original model's structure while transferring, allowing it to be imported back as the exact same object in its native framework.\label{fig:overall}](pymilo_outlook.png)

\newpage

# Statement of Need
Modern machine learning development is largely centered around the Python ecosystem, which has become a dominant platform for building and training models due to its rich libraries and community support [@Raschka2020].
However, once a model is trained, sharing or deploying it securely and transparently remains a significant challenge [@parida2025model; @davis2023reusing]. This issue is especially important in high-stake domains such as healthcare, where ensuring model accountability and integrity is critical [@Garbin2022].
In such settings, any lack of clarity about a model’s internal logic or origin can reduce trust in its predictions. Researchers have increasingly emphasized that greater transparency in AI systems is critical for maintaining user trust and protecting privacy in machine learning applications [@bodimani2024assessing].

Despite ongoing concerns around transparency and safety, the dominant approach for exchanging pretrained models remains ad hoc binary serialization, most commonly through Python’s `pickle` module or its variant `joblib`.
These formats allow developers to store complex model objects with minimal effort, but they were never designed with security or human interpretability in mind [@parida2025model]. In fact, loading a pickle file may execute arbitrary code contained within it, a known vulnerability that can be exploited if the file is maliciously crafted [@Brownlee2018; @PythonPickleDocs].
While these methods preserve full model fidelity within the Python ecosystem, it poses serious security risks and lacks transparency, as the serialized files are opaque binary blobs that cannot be inspected without loading.
Furthermore, compatibility is fragile because pickled models often depend on specific library versions, which may hinder long-term reproducibility [@Brownlee2018].

To improve portability across environments, several standardized model interchange formats have been developed alongside `pickle`.
Most notably, Open Neural Network Exchange (ONNX) and Predictive Model Markup Language (PMML) convert trained models into framework-agnostic representations [@onnx; @pmml], enabling deployment in diverse systems without relying on the original training code.
ONNX uses a graph-based structure built from primitive operators (e.g., linear transforms, activations), while PMML provides an XML-based specification for traditional models like decision trees and regressions.

Although these formats enhance security by avoiding executable serialization, they introduce compatibility and fidelity challenges.
Exporting complex pipelines to ONNX or PMML often leads to structural approximations, missing metadata, or unsupported components, especially for customized models [@pmml].
As a result, the exported model may differ in behavior, resulting in performance degradation or loss of accuracy [@jajal2023analysis].
Jajal et al. found that models exported to ONNX can produce incorrect predictions despite successful conversion, indicating semantic inconsistencies between the original and exported versions [@jajal2023analysis]. This reflects predictive performance degradation and highlight the risks of silent behavioral drift in deployed systems.

Beyond concerns about end-to-end model preservation, ONNX and PMML also present limitations in transparency, scope, and reversibility. ONNX uses a binary protocol buffer format that is not human-readable, which limits interpretability and makes auditing difficult.
PMML, although XML-based and readable, is verbose and narrowly scoped, supporting only a limited subset of scikit-learn models. As noted by Cody et al., both ONNX and PMML focus on static model specification rather than operational testing or lifecycle validation workflows [@cody2024extending]. Moreover, PMML does not provide a mechanism to restore exported models into Python, making it a one-way format that limits reproducibility across ML workflows.

Other tools have been developed to address specific use cases, though they remain limited in scope. For example, SKOPS improves the safety of scikit-learn model storage by enabling limited inspection of model internals without requiring code execution [@skops].
However, it supports only scikit-learn models, lacks compatibility with other frameworks, and does not provide a fully transparent or human-readable structure.
TensorFlow.js targets JavaScript environments by converting TensorFlow or Keras models into a JSON configuration file and binary weight files for execution in the browser or Node.js [@tfjs2019].
However, this process has been shown to introduce compatibility issues, performance degradation, and inconsistencies in inference behavior due to backend limitations and environment-specific faults [@quan2022towards].
Models from other frameworks, such as scikit-learn or PyTorch, must be re-implemented or retrained in TensorFlow to be exported.
Additionally, running complex models in JavaScript runtimes introduces memory and performance limitations, often making the deployment of large neural networks prohibitively slow or even infeasible in browser environments [@NerdCorner2025].

In summary, current solutions force practitioners into a trade-offs between security, transparency, end-to-end fidelity, and performance preservation (see Table 1).
The machine learning community still lacks a safe and transparent end-to-end model serialization framework through which users can securely share models, inspect them easily, and accurately reconstruct them for use across diverse frameworks and environments.

**Table 1**: Comparison of PyMilo with existing model serialization tools.

| Package | Transparent | Multi-Framework | End-to-End Preservation | Secure |
|------------------|-------------|------------------|--------------------------|--------|
| **Pickle** | No | Yes | Yes | No |
| **Joblib** | No | Yes | Yes | No |
| **ONNX** | No | Yes | No | Yes |
| **PMML** | Yes | No | No | Yes |
| **SKOPS** | No | No | Yes | Yes |
| **TensorFlow.js** | Yes | No | No | Yes |
| **PyMilo** | Yes | Yes | Yes | Yes |

PyMilo is proposed to address the above gaps. It is an open-source Python library that provides an end-to-end solution for exporting and importing machine learning models in a safe, non-executable, and human-readable format such as JSON. PyMilo serializes trained models into a transparent format and fully reconstructs them without structural changes, preserving their original functionality and behavior.
This process does not affect inference time or performance and imports models on any target device without additional dependencies, enabling seamless execution in inference mode.
PyMilo benefits a wide range of stakeholders, including machine learning engineers, data scientists, and AI practitioners, by facilitating the development of more transparent and accountable AI systems. Furthermore, researchers working on transparent AI [@rauker2023toward], user privacy in ML [@bodimani2024assessing], and safe AI [@macrae2019governing] can use PyMilo as a framework that provides transparency and safety in the machine learning environment.

# References
Binary file added paper/pymilo_outlook.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.