ironaccelerator-core

Backend-agnostic foundation for IronAccelerator — a high-performance, agentic-first driver substrate spanning CUDA, ROCm, Metal, and Qualcomm NPUs. This crate intentionally contains no backend bindings; it defines the trait surface every backend implements plus the vendor-neutral descriptions of the things a driver actually owns: devices, capability bits, memory, streams, events, and kernel launch geometry.

Scope. Nothing above the driver lives here. Workload descriptors, execution-strategy selection, tensor descriptors, quantization schemes, and CPU reference kernels belong to the inference engine layered on top (IronWorks), not to the substrate that talks to the driver.

IronAccelerator prioritises throughput over guard-rails. Where a traditional safe wrapper would add bounds checks, allocation tracking, or synchronous teardown, we expose a _unchecked fast path and let the agent (or library author) opt back into safety.