Path

Getting started

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

git clone https://github.com/WorldTreeNetwork/iron-lab
cd iron-lab
just install-toolchain   # uv, mlir-aie source, pyxrt — no sudo
just check               # or: cargo run -p ironlab -- doctor --plain
just hello               # vector-add on the NPU

On the NPU host (sudo, once / per boot):

just install-firmware
just build-xdna-driver
just load-driver

First operator

just run operators/dwconv_1d/design.py --no-run
just test --no-npu
just test tests/correctness/    # needs NPU; T=32 and T=375

Scaffold:

cargo run -p ironlab -- init my_op
# edit operators/my_op/{op,design,reference,test}.py
# add aie_kernels/aie2p/my_op.cc

Python is 3.12. See toolchain.md and operators.md.