gitwtfhub

wtf is pinscope?

faradworks/pinscope — explained in plain English

Analysis updated 2026-05-18

135PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

An AI-assisted schematic reviewer that reads component datasheets to catch wiring problems standard electrical rule checks miss.

Mindmap

mindmap
  root((Pinscope))
    What it does
      Reviews schematics
      Reads datasheets
      Cites findings by page
    Tech stack
      Python
      FastAPI
      Claude API
      React
    Pipeline
      Parse netlist and BOM
      Extract datasheet specs
      Per-chip AI review
      Deterministic BOM roll-up
    Use cases
      Catch datasheet violations
      Voltage derating check
      Team hardware review
    Audience
      Hardware engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Check a circuit board design against every chip's datasheet before manufacturing it.

REASON 2

Catch voltage mismatches between connected chips that standard rule checkers miss.

REASON 3

Compute a capacitor voltage derating table automatically from the design graph.

REASON 4

Get page-cited findings so an engineer can verify each flagged issue against the source datasheet.

What's in the stack?

PythonFastAPIReactNode.jsClaude API

How it stacks up

faradworks/pinscopecolossus-lab/openarg_backendmr-un1k0d3r/azureredops
Stars135135135
LanguagePythonPythonPython
Setup difficultymoderatehardmoderate
Complexity4/55/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.12+, Node 20+, and an Anthropic API key to run the review pipeline.

Free to use and modify, but if you run a modified version as a network service you must share your source code too, commercial licensing is available separately.

Wtf does this do

Pinscope reviews electronic circuit schematics the way an experienced hardware engineer would, by actually reading the datasheets for every part on the board instead of only checking general wiring rules. You give it a netlist and a bill of materials describing your design, along with the datasheet PDFs for the chips involved, and it builds a graph of how every component and wire connects to every other one. The tool exists because standard electrical rule checks in circuit design software can pass a board that still does not work. A checker has no way of knowing that a specific chip drives its output at a voltage too high for the microcontroller pin it connects to, or that a signal has been wired to a pin whose datasheet only allows a different function, or that leaving a certain pin unconnected will quietly add a large amount of electrical noise. None of that breaks a formal wiring rule, but it is written in the part's datasheet, and nobody has time to reread hundreds of pages of documentation for every part on every design revision. Pinscope works in four steps. First it parses the bill of materials and netlist, which can come from tools like KiCad, Altium, OrCAD, or EasyEDA, into a graph of components and connections. Second, it pulls the relevant pin tables and specifications out of each datasheet PDF, caching the result so a given part is only processed once. Third, it reviews each chip individually, looking at its datasheet alongside the surrounding circuit and filing findings with a severity level, its reasoning, and the exact datasheet page that supports it. Fourth, it computes things that do not need judgment at all, like a full parts list summary and a capacitor voltage derating table, directly from the graph with no AI model involved. A final pass can merge duplicate findings or lower their severity, but never raise it. Running it locally requires Python 3.12 or newer, Node 20 or newer, and an Anthropic API key, since the per-chip review step uses Claude. A hosted version with team accounts is available at pinscope.ai. The project itself is released under AGPL-3.0, with separate commercial licensing available by contacting the developer.

Yoink these prompts

Prompt 1
Walk me through running Pinscope locally on its bundled MSPM0G3507 example design.
Prompt 2
Explain how Pinscope turns a netlist and BOM into a graph of components and nets.
Prompt 3
Show me how Pinscope cites datasheet pages to back up each finding it reports.
Prompt 4
Help me set up the ANTHROPIC_API_KEY and DigiKey API keys Pinscope needs to run.

Frequently asked questions

wtf is pinscope?

An AI-assisted schematic reviewer that reads component datasheets to catch wiring problems standard electrical rule checks miss.

What language is pinscope written in?

Mainly Python. The stack also includes Python, FastAPI, React.

What license does pinscope use?

Free to use and modify, but if you run a modified version as a network service you must share your source code too, commercial licensing is available separately.

How hard is pinscope to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pinscope for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.