API reference

hawk’s public Python surface, by subpackage. The authoring names (hawk.kernel, the declarations, hawk.steps) live at the top level and the math vocabulary, including the quaternion helpers and the random distributions, at hawk.math. hawk.raw_device / hawk.RawBlock are the escape hatch: splice a block of device code the vocabulary cannot spell, with its access class declared by hand.

The compiled hawk._core extension and the IR/emitter internals (hawk.ir, hawk.emit) are implementation detail and not documented here. Their __all__ is a small “IR access” surface for a downstream package that builds or renders sink sets by hand (hawk.ir.canonical, hawk.ir.recognize, hawk.emit.render_source, …); everything else in them may change between releases.

hawk	HAWK — Hardware Agnostic Writing of Kernels.
hawk.math	hawk.math — the free-function namespace a kernel body writes math through.
hawk.ext	The extension protocol: the seams a kind DECLARES.
hawk.diff	IR -> IR autodiff, symbolic and in both directions.
hawk.compile	AOT compile drivers + the content-closure cache.
hawk.runtime	The thin Python face over hawk._core — descriptor, bind, launch.
hawk.artifact	Manifest + sidecar + the ABI exports + bundles.