Metadata-Version: 2.4
Name: halide-runtime
Version: 22.0.0.post3
Summary: Standalone Halide runtime: load and call precompiled Halide AOT kernels without depending on libHalide (no compiler, no LLVM).
Keywords: array,image processing,runtime,aot,halide
Author-Email: The Halide team <halide-dev@lists.csail.mit.edu>
Maintainer-Email: Alex Reinking <areinking@adobe.com>
License-Expression: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Image Processing
Project-URL: Homepage, https://halide-lang.org
Project-URL: Documentation, https://github.com/halide/Halide/blob/main/doc/Python.md
Project-URL: Issues, https://github.com/halide/Halide/issues
Project-URL: Repository, https://github.com/halide/Halide.git
Requires-Python: >=3.12
Requires-Dist: numpy>=1.26
Description-Content-Type: text/markdown

# halide-runtime

A tiny, standalone runtime for calling **precompiled Halide AOT kernels** from
Python, with **no dependency on libHalide** (no compiler, no LLVM).

Requires regular, GIL-enabled CPython 3.12 or newer. The `cp312-abi3` wheels use
the stable Python ABI and work unchanged on newer regular CPython versions;
free-threaded Python is not supported.

```shell
pip install halide-runtime
uv add halide-runtime
```

```python
import numpy as np
import halide.runtime as hlr

kernel = hlr.load("mykernel.so")  # dlopen a precompiled Halide artifact
out = np.empty_like(inp)
kernel(inp, out)  # call it with NumPy arrays
```

This package contributes only `halide.runtime` — `hlr.load(...)`, the resulting
`Kernel` objects, and a lightweight `hlr.Buffer` wrapper — to the implicit
`halide` namespace. It is a strict subset of the full
[`halide`](https://pypi.org/project/halide/) package; install this one for small
deployment environments that run precompiled pipelines but do not need the
Halide compiler. Python extensions produced by
`add_halide_python_extension_library` also expose this package's `Kernel` type
and therefore require `halide-runtime` when deployed independently.

See the Halide Python docs:
<https://github.com/halide/Halide/blob/main/doc/Python.md>
