Python toolkit

StorageCraft now provides a small Python package alongside the browser labs and colored JavaScript CLI. It is designed for readers who want inspectable code, notebook experiments, automation examples, or a familiar contribution path.

Run without installation

PYTHONPATH=python python3 -m storagecraft_tools.cli raid --level 6 --disks 8 --size 4
PYTHONPATH=python python3 -m storagecraft_tools.cli learn

Add --json to either command for machine-readable output.

Install locally

python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/storagecraft-py raid --level 10 --disks 8 --size 3.84

Use as a library

from storagecraft_tools import calculate_raid

plan = calculate_raid("raid6", disks=8, disk_size_tb=4)
print(plan.usable_tb, plan.efficiency)

Scope

The package covers JBOD, RAID 0–6, RAID 0+1/10/50/60, RAID-Z1/Z2/Z3, erasure coding, NVMe queue ceilings, RAG storage, GPU memory, and curriculum discovery. The browser labs remain the richer visual and guided-learning surfaces.

Open notebooks/storagecraft_quickstart.ipynb for a ready-to-run notebook tour.

Contribute

Keep the Python layer dependency-free, typed, deterministic, and tested. New models should expose a library function, structured result, CLI representation, invalid-input tests, and documentation of assumptions.

Next step

Run the Universal RAID Planner beside the Python command and compare the same configuration.