Fast PCB Hub

Fast PCB Hub is an early-stage compiler for modular, solderless carrier PCBs. It turns a versioned design description into deterministic Hardware IR after checking electrical and topology constraints.

The current repository contains the first vertical slice. It deliberately does not ask an LLM to decide electrical connections or emit KiCad files directly.

Current capabilities

• Versioned module contracts and design documents
• Module verification gate: draft and fixture data are rejected by default
• 3.3 V power-range and current-budget checks with configurable margin
• I²C controller/device, logic-voltage and address-conflict checks
• GPIO driver/receiver checks
• Physical pin reuse detection
• Deterministic Hardware IR output
• A KiCad carrier-board routing fixture with reproducible DRC evidence
• Standard-library-only Python core and tests

Run the fixture example

The bundled catalog is synthetic test data, not manufacturing data. The explicit flag is required:

PYTHONPATH=src python3 -m fast_pcb_hub compile \
  examples/environment_monitor/design.json \
  --catalog catalog \
  --allow-fixtures \
  --output build/environment_monitor.hardware.json

Run the tests:

PYTHONPATH=src python3 -m unittest discover -s tests -v

Automatic-routing proof

The generated environment-monitor fixture is a 70 mm x 50 mm, two-layer carrier board with four pluggable module sockets. Its low-speed nets were routed automatically with Freerouting and then checked again by KiCad: 18 track segments, 0 vias, 0 DRC violations, and 0 unconnected items. The fixture uses synthetic module definitions and is not fabrication approval.

Safety boundary

Hardware IR and an autorouted board are not manufacturing approval. A production board must also pass footprint provenance, mechanical collision, ERC, DRC, connectivity parity, DFM, and first-article testing gates. Unverified modules cannot enter the production path.

See the compiler boundary and routing pipeline decisions.