# FPGA Sheperd

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Stepan Filonov](https://cerebralvalley.ai/u/stepanfilonov)
- **GitHub:** https://github.com/stepacool/FPGA-shepherd
- **Demo video:** https://youtu.be/WZto-jOdbhw
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4476

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.

## More from Meta Global AI Developer Hackathon

- [Andrii AI](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4473)
- [Mentorium](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4474)
- [Will Wild](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4475)
- [SAMgo](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4477)
- [Scout](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4478)
- [Skrpt_Kpr404](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4479)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/4476. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt