Metadata-Version: 2.4
Name: kinemax
Version: 0.0.1
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Physics
License-File: LICENSE
Summary: High-performance coordinate and kinematics engine for bounded spatial tracking data.
Keywords: spatial,kinematics,tracking,geometry,telemetry
Home-Page: https://github.com/anthonysgro/kinemax
Author: Anthony Sgro
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/anthonysgro/kinemax
Project-URL: Issues, https://github.com/anthonysgro/kinemax/issues
Project-URL: Repository, https://github.com/anthonysgro/kinemax

# Kinemax

**Summary:** Kinemax is a high-performance spatial-temporal computing engine designed for analyzing high-frequency coordinate and kinematics tracking data. *"A local-first execution runtime for fixed-cardinality spatiotemporal entity systems."*

## The Vision

Whether tracking player telemetry on a sports field, monitoring mobile entities within fixed boundaries, or processing continuous $X,Y,Z$ positional vectors over time, Kinemax provides a lightweight, local-first framework optimized for rapid geometric and physical calculations. Built with a low-dependency Rust core and paired with an idiomatic Python API, it bridges the gap between systems-level execution speed and rapid data-science workflows.

> **Note:** This package is currently in active pre-alpha development. The namespace is reserved as the underlying architecture is being established.

## Quick Start (Development)

Requires [uv](https://docs.astral.sh/uv/) and a working Rust toolchain.

```bash
# Create the virtual environment (Python pin lives in .python-version)
uv venv

# Install build tooling and compile the Rust extension in-place
uv pip install "maturin>=1.9,<2.0"
.venv/bin/maturin develop

# Verify the install
.venv/bin/python -c "import kinemax; print(kinemax.version())"
```

## License

MIT

