convez.ai
MCP Server
moellere

WireStudio

moellere/WireStudio

Ver no GitHub
BomPluginScore · de 0 a 100

Agent-driven design studio for ESP32 / ESPHome + LoRaWAN devices: generates ESPHome YAML, KiCad schematic/PCB, 3D-printable enclosures, and builds/flashes/provisions LoRaWAN firmware (ChirpStack + Home Assistant).

Instalação

$npx convez-ai moellere/WireStudio

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
29
Forks
3
Acompanhando
0
Saúde
57%
Último commit
há 1 dia
Versão
v1.3.0
Issues abertas
0
Contribuidores
4

README

A tradução para o português deste README ainda está na fila.

wirestudio

Agent-driven IoT device design tool. Describe a goal (or pick parts); get ESPHome YAML, an ASCII wiring diagram, and a BOM that compile under upstream ESPHome.

A second generation target builds and flashes LoRaWAN firmware (RadioLib + LoRaWAN_ESP32) for US915 radio boards — TTGO T-Beam / LoRa32, Heltec WiFi LoRa 32 V2/V3 — over WebSerial from the browser, and provisions the device against ChirpStack.

Produces ESPHome configs but is not affiliated with the ESPHome project — see weirded/fleet-for-esphome for the OTA-deploy companion this studio's Push to fleet flow talks to.

Documentation

Detailed docs live in docs/:

Status

v0.13.0 — on PyPI (pip install wirestudio). The studio has wide surface area (YAML, schematic, enclosure, agent, MCP server, fleet handoff, web UI, a LoRaWAN flash/provision target) and a set of things actually verified against upstream tools. Three of the four priority tiers (YAML, wiring schema, enclosure) are now gated in CI, and every library component and board is exercised by a bundled example that passes those gates. This section is honest about which is which, ordered by how much it matters that it works.

Tiers, in priority order:

TierAreaWhat it doesVerified by
VerifiedESPHome YAML productionrender design.json → ESPHome YAMLesphome config passes on every bundled example, every PR (gate); nightly esphome compile smoke against a representative example (compile)
VerifiedCSP pin solver + compat checkerassign legal pins, surface boot-strap / ADC2-WiFi / voltage / locked-pin issuesunit tests + property checks in tests/test_pin_solver.py + tests/test_compatibility.py
VerifiedFleet handoffpush YAML to fleet-for-esphome ha-addon, optional compile + log relayround-trip tests in tests/test_fleet.py
VerifiedKiCad schematicemit a SKiDL Python script the user runs locally to produce a .kicad_schevery bundled example builds a KiCad netlist against the pinned upstream symbol libraries, every PR (gate) — no unresolved symbols or pins. Parts KiCad ships no symbol for (sensor/module breakouts) render as labeled generic headers
VerifiedParametric enclosureOpenSCAD .scad from board mount-hole metadataevery enclosure-capable board renders through real OpenSCAD to a non-empty, manifold (closed, printable) solid, every PR (gate)
Works (hardware-validated)LoRaWAN targetbuild RadioLib + LoRaWAN_ESP32 firmware for US915 radio boards, flash over WebSerial, provision against ChirpStackevery radio board's firmware builds in CI (gate); validated end-to-end on a TTGO T-Beam against live ChirpStack 4.17 — no automated live-device gate
Works (lighter checks)MCP serverdrive the design tools from Claude Code / Desktop over the Model Context Protocoltool / auth / resource tests in tests/test_mcp_*.py; not exercised against a live MCP client in CI
ExperimentalThingiverse search relayrank community models for a boardsmoke-tested; depends on a third-party search API that ranks unevenly
ExperimentalAgent (Claude tool-using)natural-language design drivingworks in practice; tool surface is small; no auto-eval against task list yet
DeferredKiCad PCB layoutFreerouting + Gerber + JLCPCB CPL/BOM1.0+, not started

The Verified tier is the bar the project is asking to be judged on. Everything else is offered with the caveat that's spelled out in the table.

See CONTRIBUTING.md for the bar a change has to clear before merging, CHANGELOG.md for per-release deltas, and START.md for the longer-form design notes.

Tested against ESPHome ==2025.12.7 (pinned in .github/workflows/esphome-config.yml + bumped deliberately). When that pin moves, this line moves with it.

Quickstart

Docker

docker run --rm -p 8765:8765 \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -v wirestudio-data:/data \
  ghcr.io/moellere/wirestudio:v0.13.0

Open http://localhost:8765. The image bundles the FastAPI server + the built web UI in one process. See Deployment for image tags, env vars, and the Kubernetes manifest.

CLI

pip install wirestudio                       # from PyPI
# ...or, for a dev checkout:  pip install -e .[dev]
python -m wirestudio.generate wirestudio/examples/garage-motion.json

Prints rendered YAML and the ASCII wiring block to stdout.

HTTP API

python -m wirestudio.api                    # localhost:8765
python -m wirestudio.api --reload           # dev mode (auto-reload on edits)

Browse the auto-generated OpenAPI docs at http://127.0.0.1:8765/docs. The agent, fleet handoff, and MCP surfaces are each gated by an env var — see Integrations.

Web UI (dev)

# In one terminal:
python -m wirestudio.api
# In another:
cd web && npm install && npm run dev

Open http://localhost:5173; Vite proxies /api/* to the studio API. The User guide walks the panes and header actions.

Tests

python -m pytest                          # ~680 cases
python -m ruff check .                    # lint
cd web && npx vitest run                  # vitest + jsdom
pip install 'esphome==2025.12.7'
python scripts/check_examples.py          # the YAML gate -- every example through `esphome config`

The esphome config gate is the headline test: it renders every bundled example through the studio and runs upstream ESPHome's own validator against the output. The GitHub Actions workflow runs the YAML gate + the full suite + multi-arch image build on every PR and merge to main. A nightly compile-smoke runs esphome compile against a representative example. To run the gate before every push:

pip install pre-commit
pre-commit install --hook-type pre-push

Contributing

CONTRIBUTING.md is the substantive bar — what "working" means for the artifacts the studio produces, including the esphome config gate every PR has to clear. CLAUDE.md covers the prose / commit / comment conventions (concise, no emojis, default-to-no-comments, boundary-only validation, no premature abstraction).

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados