Repository navigation
v0.1.0 Initial Release
The first public release of BreadPilot: describe a hardware project in plain words and build it step by step on a 3D breadboard.
What's in it
- Idea → plan: clear ideas are planned at once; vague ones get a short plan to approve or change.
- Safe wiring: code picks the pins, places the parts and draws every wire. A validator checks for shorts, missing resistors, 5 V on a GPIO and more before any step is shown.
- 3D steps: numbered wiring steps on an interactive breadboard, each with a plain-English "why".
- Checked code: MicroPython is generated and cross-checked against your wiring, and re-checked live when you edit it.
- Build for Pico: one
.uf2with MicroPython and your code. Drag it onto the Pico and it runs. - Local first: runs on your computer with Docker and Ollama (
qwen3:4b-instruct-2507+nomic-embed-text). An OpenAI model is optional, per project.
Supported hardware
Raspberry Pi Pico 2 W / 2 WH, 5 mm LEDs, 6 mm push buttons, 10 kΩ potentiometers, 1.3" I2C OLED (SH1106, 128x64). Other parts get a handoff bundle for a stronger assistant.
Install
Download BreadPilot-v0.1.0.zip, unzip it and follow Quick start in README.md (Docker + Ollama, about 3 GB of AI models).
Tested on macOS (Apple Silicon). Windows and Linux are supported but not tested yet. Feedback is welcome in Issues.
⚠️ BreadPilot gives wiring and code suggestions for real electronics. Double-check before powering your circuit.