selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Wrench Board logo

Self-host Wrench Board

v1.3.4

AI diagnostic workbench for microsoldering and board repair

BetaSource AvailableOther
Updated3 months ago
LanguagePython
Setup difficultyAdvanced
Stars
250
Port
8000 (HTTP/WebSocket server)
Install with Python
Boardview + diagnostic agent on an MNT Reform motherboardRepair dashboard with knowledge artefacts and diagnostic threads

What is Wrench Board?

Wrench Board is a diagnostic workbench for board-level electronics repair, built by a microsoldering technician for the right-to-repair community. It ingests a schematic PDF and a boardview file (supporting 16 formats including KiCad, OpenBoardView, and various vendor formats), compiles them into a queryable electrical graph with classified nets and inferred boot sequences, and runs a Claude Opus 4.8 diagnostic agent that pilots the boardview visually through 44 custom tools. The agent never fabricates reference designators — every refdes originates from a tool lookup, with a server-side sanitizer wrapping unverified tokens. Two pure-sync deterministic engines (simulator and hypothesizer) provide verifiable causal chains without LLM calls at runtime. The system includes a Knowledge Factory with four Claude personas that build verified repair packs in ~2 minutes, a microsolder-evolve overnight self-improvement loop, and camera integration for live microscope/webcam capture. It runs locally via Python 3.11+/FastAPI on port 8000, requires an Anthropic API key, and uses file-based memory stores (no database). The license is proprietary source-available: free for personal evaluation, study, and local use, and independent repair professionals may use it commercially as an internal tool. Redistribution, hosted SaaS deployment, and AI training use require written permission.

Should you self-host Wrench Board?

Wrench Board scores 40/100 on selfhost.directory (how scoring works) and ranks #134 of 166 in Developer Tools. It has 250 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v1.3.4, came out on 20 June 2026. New versions land roughly every 4 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is openhands (87/100, 92 105 stars). It scores higher overall, so compare the two before you pick. See Wrench Board vs openhands side by side.

Features

  • Anti-hallucination sanitizer
  • Boardview parsing (16 formats)
  • Camera integration (USB microscope/webcam)
  • Deterministic simulator & hypothesizer
  • Diagnostic agent with 44 custom tools
  • Dual runtime (Managed Agents / Direct API)
  • Knowledge Factory (4 Claude personas)
  • Microsolder-evolve overnight self-improvement
  • Per-device layered memory
  • Schematic PDF ingestion

Wrench Board README

How to install Wrench Board

Install Wrench Board with Python

Environment variables
ANTHROPIC_API_KEY, ANTHROPIC_MODEL_MAIN, ANTHROPIC_MODEL_FAST, PORT, LOG_LEVEL, ENGINE_SERVICE_TOKEN, CLOUD_METERING_URL, CLOUD_METERING_TOKEN, WRENCH_BOARD_FZ_KEY, WRENCH_BOARD_XZZ_KEY

git clone https://github.com/Junkz3/wrench-board cd wrench-board make install # create .venv and install deps (incl. [dev]) cp .env.example .env # then fill in ANTHROPIC_API_KEY make run # uvicorn --reload on http://localhost:8000

Requires Python 3.11+ and Anthropic API key. Binds to 127.0.0.1 by default; use HOST=0.0.0.0 for LAN access.

How to configure Wrench Board

  • ANTHROPIC_API_KEYAnthropic API key for Claude models

    Anthropic API key for Claude models

  • ANTHROPIC_MODEL_FASTclaude-haiku-4-5Fast model for validation / formatting / cheap classification

    Fast model for validation / formatting / cheap classification

  • ANTHROPIC_MODEL_MAINclaude-opus-4-8Main reasoning model (agent loop, tool planning)

    Main reasoning model (agent loop, tool planning)

  • CLOUD_METERING_TOKENCloud metering token

    Cloud metering token

  • CLOUD_METERING_URLCloud metering endpoint URL

    Cloud metering endpoint URL

  • ENGINE_SERVICE_TOKENShared secret for cloud gateway authentication

    Shared secret for cloud gateway authentication

  • LOG_LEVELINFOLog level

    Log level

  • PORT8000Server port

    Server port

  • WRENCH_BOARD_FZ_KEYFZ-xor cipher key for encrypted .fz files

    FZ-xor cipher key for encrypted .fz files

  • WRENCH_BOARD_XZZ_KEYXZZ DES master key for encrypted .pcb files

    XZZ DES master key for encrypted .pcb files

Wrench Board releases & version history

More in Developer Tools

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…