FPGA Sheperd

FPGA Shepherd is a command-line tool that makes FPGAs (field-programmable gate arrays) much easier to adopt, so getting real hardware into the loop for physical AI stops being a toolchain fight. You bring the HDL design and Shepherd handles the rest: - Setup: a one-line install script, then shepherd init installs the full open-source FPGA toolchain (Yosys, nextpnr, openFPGALoader) and writes a shepherd.toml project file. It can also adopt an existing repo by detecting the HDL, top module, sources and constraints. - Build and flash: shepherd build and shepherd upload run synthesis, place-and-route, packing and programming. Verilog/SystemVerilog builds directly; Amaranth is converted to Verilog first. - Diagnosis: when a step fails, a VerifyAgent first checks the logs against known error signatures. For failures it doesn't recognize, shepherd explain and shepherd ask send the cleaned-up logs and board knowledge to Meta Llama, which returns a plain-language cause and a concrete fix. - Live view: shepherd ui opens a local web dashboard that shows runs, steps and diagnoses as they happen, backed by a SQLite event log. v0 supports the Tang Nano 9K board.