Metadata-Version: 2.3
Name: mtrick
Version: 0.6.0
Summary: A local, zero-config ML experiment tracker
Author: Avik Arefin
Author-email: Avik Arefin <avik.me.arefin@gmail.com>
License: Apache-2.0
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: System :: Logging
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Project-URL: Repository, https://github.com/AvikArefin/mtrick
Description-Content-Type: text/markdown

# mtrick: Metrics Tracker
A local simple ML experiment tracker with zero configurations required.

## Installation

```
uv add mtrick
```
or 
```
pip install mtrick
```


If you want the latest version

```
uv add git+https://github.com/AvikArefin/mtrick.git
```
or 

```bash
pip install git+https://github.com/AvikArefin/mtrick.git
```

## Usage

Initialize tracker:
```python
from mtrick import Tracker
t = Tracker("exp_name")
```

Scalar metrics (epoch-based curves):
```python
t.log({"loss/train": 0.1, "loss/val": 0.2, "accuracy": 0.95}, epoch=1)
```

2D Spatial Points & Trajectories:
```python
t.log_2d(
    data={
        "data/true": [[1.0, 2.0], [2.0, 3.0]],
        "data/pred": [[1.1, 1.9], [2.1, 3.1]],
    },
    epoch=1
)
```

Matrices (Confusion Matrix):
```python
t.log_matrix(
    matrix=[[9, 1], [2, 8]],
    labels=["Cat", "Dog"],
    step=1
)
```

## Changelog
[See CHANGELOG.md](https://github.com/AvikArefin/mtrick/blob/main/CHANGELOG.md)
