Arduino Shield

AMD-Link

Pipeline that turns a natural-language prompt plus an unrouted .kicad_pcb into a routed PCB and a Gerber set, using KiCadRoutingTools (KRT) as the routing engine.

prompt + .kicad_pcb
        │
        ▼
┌──────────────────────────────────────────────────────────────-----------┐
│ orchestrator                                                            |
│   ingest  ─►  extract  ─►  route (KRT)  ─►  check (DRC + Gerber export) │
└─────────────────────────────────────────────────────────────-----------─┘
        │
        ▼
   routed.kicad_pcb  +  gerbers/

One-time setup

1. Clone with submodules

git clone --recurse-submodules <this-repo>
# or, if already cloned:
git submodule update --init --recursive

2. Install prereqs

• Rust toolchain — required to build the KRT Rust router. Install via rustup.rs (curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh).
• kicad-cli — required for DRC and Gerber export. Install KiCad 9 or 10 and ensure kicad-cli is on PATH, or set KICAD_CLI=/path/to/kicad-cli.
• Python 3.10+ with the project deps:

pip install -r requirements.txt
pip install -r external/KiCadRoutingTools/requirements.txt

3. Build the KRT Rust router

./scripts/setup_krt.sh

This runs python build_router.py inside the submodule and verifies that route.py --help works.

Override the KRT location or interpreter via env vars:

KRT_ROOT=/abs/path/KiCadRoutingTools KRT_PYTHON=python3.12 ./scripts/setup_krt.sh

Running the pipeline

Single natural-language driver (full pipeline + Gerber export):

python -m orchestrator --prompt "route DDR5 signals on board.kicad_pcb"

Stage-level driver:

python -m orchestrator --pcb path/to/board.kicad_pcb --gerber-dir runs/out/gerbers

See orchestrator/__init__.py for full CLI options.

Layout