Skip to main content

CairnML

CairnML records what your training scripts do (parameters, metrics, logs, artifacts), runs them on remote machines through job queues, and versions datasets with git and DVC so every run records the exact data it used.

This is the Python SDK. It needs a CairnML server (see cairnml-server and the deployment files).

CairnML is an unofficial, modified version of ClearML. It is not created, sponsored, endorsed or supported by ClearML, Inc. See DISCLAIMER.md and NOTICE.

Install

pip install cairnml
pip install "cairnml[dataset]"   # adds the dataset tools (DVC, Parquet)

Use

Sign this machine in to your server once:

cairnml-init --server https://your-server:8008

Track a script:

from cairnml import Task

task = Task.init(project_name="demo", task_name="first run")
task.connect({"lr": 0.001})
task.get_logger().report_scalar("loss", "train", value=0.5, iteration=1)

Run a recorded task on an agent (cairnml-agent):

Task.enqueue(task, queue_name="default")

Version a dataset (a dataset is a git repository, its commit is its version):

cairnml-dataset init
cairnml-dataset add
cairnml-dataset commit -m "March measurements"
cairnml-dataset push

See docs/datasets.md for datasets, adapters and the cache.

License

Apache License 2.0, see LICENSE. Based on ClearML, Copyright 2025 ClearML Inc.

Metadata

Release files for cairnml 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cairnml 0.0.1
File Size Uploaded Provenance Actions
cairnml-0.0.1.tar.gz 1.3 MB With provenance Details for cairnml-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cairnml 0.0.1
File Interpreter ABI Platform Actions
cairnml-0.0.1-py2.py3-none-any.whl Python 3, Python 2 none any Details for cairnml-0.0.1-py2.py3-none-any.whl

Total release size: 2.7 MB

Release files / cairnml-0.0.1.tar.gz

Download URL cairnml-0.0.1.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
b41dd37d4775ffcd1564dcaad96bbde33bb3e3c582edb5c183b040a015e6aa5b
BLAKE2b-256 checksum
How to use checksums
2beb2a4704d548b6a8dab83e09a288adec9f258a7d8b77c8df05d30aa57c1b73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / cairnml-0.0.1-py2.py3-none-any.whl

Download URL cairnml-0.0.1-py2.py3-none-any.whl
Size 1.4 MB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
19993e64c24d838d550392a334f6476615d25ed5e63fb72a4b5559e0e06c9553
BLAKE2b-256 checksum
How to use checksums
844cf54f2b2b52b76190bc792e183e013c5f1160486deee5ec8f77472a0937d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for cairnml 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cairnml-0.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page