fabgate 0.1.0

Pre-fab PCB design review and release gate for KiCad boards

FabGate

Pre-fab PCB design review and release gate for KiCad boards.

v0.1 — evaluate your board, get a scored pass/hold/fail report, and a fix checklist before fabrication.

Prerequisites

• Python 3.11+
• KiCad 9+ with kicad-cli available

Install

pip install fabgate

Optional deep physics review (EMC / power / signal integrity):

pip install "fabgate[emcopilot]"

Quick start

# Check toolchain
fabgate doctor

# Review an existing KiCad project
fabgate evaluate "C:\path\to\your-kicad-project"

# CI / release gate (exit 0=pass, 1=hold, 2=fail)
fabgate gate "C:\path\to\your-kicad-project"

# Open board in KiCad
fabgate open "C:\path\to\your-kicad-project"

Reports are written to reports/ as HTML + JSON.

What it checks

Check	Engine
DRC violations	KiCad kicad-cli
Schematic parity	KiCad
EMC / power / SI physics	emcopilot (optional)
Scoring + pass/hold/fail	FabGate rules

FabGate does not call an LLM. It uses deterministic KiCad and physics-based analyzers.

Commands

Command	Purpose
fabgate doctor	Check KiCad CLI + optional emcopilot
fabgate evaluate	Full evaluation + HTML report
fabgate review	Basic review
fabgate gate	CI exit code
fabgate optimize run	Optimization plan + safe auto-fixes
fabgate auto run	Autonomous optimize loop (with rollback guardrail)
fabgate design create	Scaffold new KiCad project
fabgate workflow	Design → evaluate → optimize
fabgate open	Open in KiCad GUI

Development install

git clone <repo-url>
cd fabgate
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev,emcopilot]"
fabgate doctor

License

MIT