Metadata-Version: 2.4
Name: model-tools-ml
Version: 0.1.4
Summary: Diagnostics, analysis, and visualization for ML model development
Author-email: Alex & Claude <python@iitsp.com.au>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Alex-Glebov/model-tools
Project-URL: Repository, https://github.com/Alex-Glebov/model-tools.git
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.24.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: homebrewlibra[io]>=0.2.4
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Provides-Extra: tests
Requires-Dist: pytest>=8.0; extra == "tests"
Requires-Dist: pytest-cov>=5.0; extra == "tests"
Dynamic: license-file

# Model Tools

Diagnostics, analysis, and visualization for ML model development.

## Purpose

This package provides utilities used across model sub-projects:
- **analysis** — Chain-length analysis, metrics computation
- **viz** — Training curves, market plots (OHLCV, peaks, volume)
- **io** — Thin wrappers around homebrewlibra I/O

**What is NOT here:**
- Data preparation (sliding window, standardize, split) → `data-prep`
- Model-specific tensor loading → `model-core`

## Installation

```bash
# From PyPI
pip install model-tools-ml

# Editable (local)
pip install -e .

# With tests
pip install -e ".[tests]"

# From GitHub
pip install git+https://github.com/Alex-Glebov/model-tools.git
```

## Package Structure

```
model_tools/
├── analysis/      # Chain analysis, metrics
│   └── analyze_chains.py
├── viz/           # Visualization
│   ├── plot_metrics.py
│   ├── plot_price_peaks.py
│   └── market_plots.py
└── io/            # I/O wrappers (homebrewlibra)
```

## Usage

```python
import model_tools
print(model_tools.__version__)  # 0.1.3

# Analysis
from model_tools.analysis import analyze_all_chains
min_len, max_len, mean_len, all_lengths = analyze_all_chains(data_path)

# Visualization
from model_tools.viz import plot_training_history
plot_training_history(config_path)
```

## Tests

```bash
pytest tests/ -v
```

## Version

`0.1.3` — defined in `pyproject.toml`.

## Author

Alex & Claude <python@iitsp.com.au>
