AMD AI Engine · Linux

IRON Lab

Develop, load, and occupy AMD AI Engine programs on Ryzen AI NPUs.

Linux owners of Ryzen AI NPUs still get a brick. FastFlowLM is a closed zoo. mlir-aie is a compiler, not a device toolset.

IRON Lab is the missing path: write IRON/Peano tile kernels, keep two processes from clobbering a loaded design, and check whether the NPU is actually usable.

This is not a model compiler. Parakeet ASR is a first-party operator set, not the product.

Product

What it is

A kernel lab for AMD AI Engine NPUs. Not a compiler. Not FastFlowLM. Not an ASR runtime.

Target

Hardware

Krackan Point / NPU6 is the supported programming target. Other AMD NPUs may be detected; they are not a compile/load guarantee.

Interface

ironlab CLI

ratatui + clap. doctor, status, load, init. Default is status when you have a TTY.

Device

Occupancy

XRT will run two NPU clients at once. v1 protection is an exclusive advisory flock, not a daemon.

Layout

Operators

One directory per operator, matching amd/IRON. C++ in aie_kernels/aie2p. Shared compile helper.

Versions

Toolchain

Four pieces must version-match. Pins live in toolchain-pins.toml. Do not use uv run.

Path

Getting started

Clone, install the userspace toolchain, doctor, hello, then an operator --no-run.

Consumer

Parakeet

First-party operator set in this lab, not a second repo and not the product.

Map

Neighbours

Compiler, operator library, Linux bring-up, and the closed zoo. Dual MIT OR Apache-2.0 here.