Metadata-Version: 2.4
Name: hypertensor-runtime
Version: 0.1.0
Summary: Native C runtime (geodessical binary + libhypercore) for the HyperTensor framework
Author-email: William Ken Ohara Stewart <nagusamecs@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/NagusameCS/HyperTensor
Keywords: hypertensor,runtime,geodessical,hypercore,native
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# hypertensor-runtime

Installable Python package wrapping the **geodessical** C binary and the
**libhypercore** shared library so they can be installed via pip alongside the
rest of the HyperTensor ecosystem:

| Package | Role |
|---|---|
| `hypertensor-framework` | Pure-Python research framework |
| `hypertensor-core`      | Python bindings + core algorithms |
| `hypertensor-runtime`   | **This package** — native binaries |
| `ht-repro`              | Reproduction CLI + web UI |

## Install

```bash
pip install hypertensor-runtime
geodessical --help
```

If a binary is not bundled for your platform you'll get a clear error pointing
at the build instructions.

## Building wheels per platform

Bundled binaries live under `hypertensor_runtime/bin/<platform>/` where
`<platform>` is e.g. `linux-x86_64`, `win-amd64`, `mac-arm64`.

Local build (Windows host):

```powershell
cd ..
.\build_host.ps1
mkdir -p hypertensor_runtime\bin\win-amd64
copy build_host\geodessical.exe hypertensor_runtime\bin\win-amd64\
copy build_host\hypercore.dll   hypertensor_runtime\bin\win-amd64\
python -m build --wheel hypertensor_runtime
```

Linux / macOS (via cibuildwheel):

```bash
cibuildwheel --config-file deploy/cibuildwheel.toml hypertensor_runtime
```

## Programmatic access

```python
from hypertensor_runtime import geodessical_path, libhypercore_path
print(geodessical_path())     # absolute Path to the bundled binary
print(libhypercore_path())    # absolute Path to the shared lib
```

`ht_repro.runtime_loader` will pick these up automatically when both packages
are installed.
