Hardware ID & Annotation

May 4, 2026 · View on GitHub

Identify and annotate hardware components from photos — circuit boards, motherboards, dev boards, ICs, modules. Claude visually inspects images, catalogs components with bounding boxes and part numbers, renders annotated overlays, and cross-checks identified parts against manufacturer datasheets.

Companion to Claude-Image-Annotation-Plugin — that plugin handles general manual annotation; this one is purpose-built for hardware identification.

Skills

  • onboard — first-run setup; creates the data tree and config
  • install-deps — install Pillow (required) and optional opencv-python / pdfplumber
  • prep-photo — pre-process a photo (EXIF rotate, de-skew, crop, enhance) for cleaner ID
  • identify-components — Claude visually inspects an image and produces a structured components.json with type, part number, bounding box, and confidence per part
  • annotate-board — render an annotated overlay PNG (boxes, labels, legend) from components.json
  • cross-check-specs — fetch manufacturer datasheets for identified part numbers and verify the visual ID against spec
  • generate-bom — emit a structured Bill of Materials (markdown + CSV) from a components record

Typical flow

  1. prep-photo on the raw shot (optional)
  2. identify-components — produces data/<board>/components.json
  3. annotate-board — produces an annotated PNG
  4. cross-check-specs — confirms part numbers against datasheets
  5. generate-bom — final BOM artifact

Data storage

All plugin data lives under:

${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/hardware-id-annotation/

Subdirs: data/ (per-board records), cache/datasheets/, state/, output/ (annotated images).

External tools referenced

  • Pillow — image overlay rendering (required)
  • OpenCV — de-skew and crop-to-board (optional)
  • pdfplumber — datasheet text extraction (optional)
  • kImageAnnotator — for hand-tweaking overlays after rendering

Installation

claude plugins install hardware-id-annotation@danielrosehill

License

MIT