# wireviz/WireViz

Easily document cables and wiring harnesses.

Repository: https://github.com/wireviz/WireViz
Canonical: https://ross.abutalabs.com/products/wireviz
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: hardware, wiring-diagram, cables, connectors, wiring-harness
Last push: 2026-06-06T09:54:06+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 86, release rhythm 8, longevity 100
- inputs: {"age_days": 2296, "days_push": 88, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5231, forks 311 (observed 2026-08-28T04:09:13.432051+00:00)

## What it is
WireViz is a Python tool for easily documenting cables, connectors, and wiring harnesses. It takes simple YAML descriptions and generates wiring diagrams, bills of materials, and build instructions.

## Use cases
- document cables and wiring harnesses for electronics projects
- generate wiring diagrams from YAML descriptions
- create bills of materials for cable assemblies
- produce build instructions for harness fabrication
- version-control electrical documentation alongside source code

## When to choose
- you need reproducible, text-based wiring documentation
- you want diagrams and BOMs generated from simple YAML files
- you document harnesses in Git and want diffable docs

## When to avoid
- you need interactive graphical CAD-style schematic capture
- you require full ECAD integration or netlist exchange with PCB tools

## Facets
- artifact type: cli-tool
- maturity: active
- function: documentation, data-visualization, cli
- domain: developer-tools, hardware, documentation
- platform: python, cli, cross-platform
- tags: wiring-diagram, wiring-harness, cables, connectors, yaml-input, diagram-generation, automation

## Member repositories
- wireviz/WireViz (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:13.432051+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:59:39.306573+00:00, confidence not recorded.
  - registry_pypi: https://pypi.org/pypi/wireviz/json (fetched 2026-08-29T08:54:55.047197+00:00, sha ef2fbb73b25f)
- Data as of 2026-08-30T08:39:29.467469+00:00.