Metadata-Version: 2.3
Name: artifact-experiment
Version: 0.1.3
Summary: Artifact-ML experiment orchestration: declarative builder toolkit for reusable validation workflows with integrated tracking.
License: MIT
Author: Vasileios Ektor Papoulias
Author-email: hector.papoulias@gmail.com
Requires-Python: >=3.11,<3.14
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: artifact-core (>=0.1.4,<0.2.0)
Requires-Dist: clearml (>=2.0.0,<3.0.0)
Requires-Dist: ipywidgets (>=8.1.7,<9.0.0)
Requires-Dist: mlflow (>=2.22.0,<3.0.0)
Requires-Dist: neptune (>=1.14.0,<2.0.0)
Requires-Dist: tqdm (>=4.67.1,<5.0.0)
Project-URL: Bug Tracker, https://github.com/vasileios-ektor-papoulias/artifact-ml/issues
Project-URL: Documentation, https://artifact-ml.readthedocs.io/en/latest/artifact-experiment
Project-URL: Homepage, https://github.com/vasileios-ektor-papoulias/artifact-ml
Project-URL: Repository, https://github.com/vasileios-ektor-papoulias/artifact-ml
Description-Content-Type: text/markdown

# ⚙️ artifact-experiment

> Declarative builder toolkit for reusable validation workflows with integrated tracking.

<p align="center">
  <img src="https://raw.githubusercontent.com/vasileios-ektor-papoulias/artifact-ml/main/artifact-experiment/assets/artifact_ml_logo.svg" width="400" alt="Artifact-ML Logo">
</p>

[![PyPI - Version](https://img.shields.io/pypi/v/artifact-experiment.svg)](https://pypi.org/project/artifact-experiment/)
[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](https://artifact-ml.readthedocs.io/en/latest/artifact-experiment)
[![Python Versions](https://img.shields.io/pypi/pyversions/artifact-experiment.svg)](https://pypi.org/project/artifact-experiment/)
![License](https://img.shields.io/github/license/vasileios-ektor-papoulias/artifact-ml)

[![CI](https://img.shields.io/github/actions/workflow/status/vasileios-ektor-papoulias/artifact-ml/ci_push_main.yml?branch=main&label=CI)](https://github.com/vasileios-ektor-papoulias/artifact-ml/actions/workflows/ci_push_main.yml)
[![Coverage](https://codecov.io/gh/vasileios-ektor-papoulias/artifact-ml/branch/main/graph/badge.svg?flag=experiment)](https://codecov.io/gh/vasileios-ektor-papoulias/artifact-ml/flags#experiment)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=vasileios-ektor-papoulias_artifact-experiment&metric=alert_status&branch=main)](https://sonarcloud.io/summary/new_code?id=vasileios-ektor-papoulias_artifact-experiment&branch=main)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=vasileios-ektor-papoulias_artifact-experiment&metric=sqale_rating&branch=main)](https://sonarcloud.io/summary/new_code?id=vasileios-ektor-papoulias_artifact-experiment&branch=main)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=vasileios-ektor-papoulias_artifact-experiment&metric=reliability_rating&branch=main)](https://sonarcloud.io/summary/new_code?id=vasileios-ektor-papoulias_artifact-experiment&branch=main)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=vasileios-ektor-papoulias_artifact-experiment&metric=security_rating&branch=main)](https://sonarcloud.io/summary/new_code?id=vasileios-ektor-papoulias_artifact-experiment&branch=main)
---

## 📋 Overview

`artifact-experiment` constitutes the experiment orchestration extension to [Artifact-ML](https://github.com/vasileios-ektor-papoulias/artifact-ml).

It provides tools to build reusable validation workflows with integrated tracking.

It stands alongside:

- [`artifact-core`](https://github.com/vasileios-ektor-papoulias/artifact-ml/tree/main/artifact-core): a unified interface for the declarative computation of diverse validation artifacts in ML experiments.
- [`artifact-torch`](https://github.com/vasileios-ektor-papoulias/artifact-ml/tree/main/artifact-torch): PyTorch integration for building reusable deep-learning workflows declaratively.

## 🚀 Installation

Clone the [**Artifact-ML monorepo**](https://github.com/vasileios-ektor-papoulias/artifact-ml/tree/main) by running:

```bash
git clone https://github.com/vasileios-ektor-papoulias/artifact-ml.git
```

Install the `artifact-experiment` package by running:

```bash
cd artifact-ml/artifact-experiment

poetry install
```

## 📚 Documentation

Documentation for `artifact-experiment` is available at [**artifact-experiment docs**](https://artifact-ml.readthedocs.io/en/latest/artifact-experiment).

## 🤝 Contributing

Contributions are welcome!

Please consult our [**contribution guidelines document**](https://artifact-ml.readthedocs.io/en/latest/Development/contributing).

## 📄 License

This project is licensed under the [MIT License](https://img.shields.io/github/license/vasileios-ektor-papoulias/artifact-ml).
