hyper-post

Offline rank fusion of a prediction array with an embedded reference. Intended for a one-line call at the end of a training script:

from hyper_post import finalize

result = finalize(predictions, target="y2", strength=0.00767)

The package does not load or save files, does not use the network, and does not upload predictions.

Install

Python 3.12, NumPy 1.26.x. Use a wheel that matches the platform:

pip install --no-index --find-links=wheelhouse hyper-post

There is no pure-Python fallback. If the native extension cannot load, installation or import fails.

API

def finalize(
    predictions: np.ndarray,
    *,
    target: Literal["y1", "y2"],
    strength: float = 0.00767,
) -> np.ndarray: ...

float64 values are ranked at original precision. The function does not modify the input. y1 and y2 are independent references and are never mixed.

Support matrix (v0.1.0)

macOS, ARM, and free-threaded CPython are out of scope for this version. Linux wheels are built on the project's WSL Ubuntu host. They are not manylinux images unless a container toolchain is added later; the training machine must have a compatible glibc.

Build (private environment)

python tools/build_payload.py
maturin build --release --out dist
python tools/inspect_wheel.py dist/*.whl

private/y1.npy and private/y2.npy are required to generate the payload. generated/ is local build output and must not be published or committed.

Security boundary

This package raises the cost of extracting the embedded reference from the wheel. It does not make the reference unrecoverable.

The public formula is output = (1 - s) * R(X) + s * R(Y). When s != 0, a caller who also knows X can recover R(Y) from the returned array. strength=1 returns the reference rank directly. That is a property of the API, not a defect to be papered over by renaming functions or packing the binary.

Runtime is fully offline. Keys needed for decryption are necessarily present in the native extension.

License

MIT. Publishing a wheel is a separate step from implementing this package and is not implied by the license text.