Repository navigation
Releases
v0.2.0 Desktop App Release
BreadPilot v0.2.0: The Desktop App
BreadPilot is now a desktop app for macOS, Windows and Linux. No Docker, no database
server, no terminal: download, open, and describe your first project.
Downloads
| File | For |
|---|---|
BreadPilot-0.2.0-arm64.dmg |
Mac with Apple silicon (M1 or newer) |
BreadPilot-0.2.0-x64.dmg |
Intel Mac (not tested yet) |
BreadPilot-0.2.0-Setup.exe |
Windows 10 and 11, 64-bit |
BreadPilot-0.2.0-x86_64.AppImage |
Linux, 64-bit Intel/AMD |
SHA256SUMS.txt |
Checksums to verify your download |
What's new
- Desktop app. Everything runs inside one app: the database, the documentation search and the
code checks. Your projects are saved encrypted on your computer. - First-run setup and a guided tour. BreadPilot checks Ollama, downloads the AI models with one
click and shows you around. - Settings. Add your own OpenAI key (only ever sent to OpenAI, shown as its last 4 characters),
pick the local AI models and how long they stay in memory. - Safe key storage. The key to your projects is kept by your operating system: the macOS login
keychain, Windows' protection for your user account, or your Linux keyring. - Better breadboard layouts. Parts go on both halves of the breadboard (twice as many fit), and
wires are spread so neighbouring wires don't crowd each other.
Install
macOS (macOS 15 Sequoia and newer)
- Open the
.dmgand drag BreadPilot into Applications. - Open BreadPilot. macOS says it could not verify the app: click Done (not Move to Trash).
- Open System Settings → Privacy & Security and click Open Anyway next to BreadPilot.
- Click Open. From then on BreadPilot opens normally.
On macOS 14 and older: right-click BreadPilot → Open → Open. BreadPilot isn't signed with a
paid Apple Developer ID yet, which is why macOS asks once.
Windows
- Run
BreadPilot-0.2.0-Setup.exeand install (no administrator rights needed). - If Windows says "Windows protected your PC", click More info → Run anyway. BreadPilot isn't
signed with a paid code-signing certificate yet.
Linux
chmod +x BreadPilot-0.2.0-x86_64.AppImage
./BreadPilot-0.2.0-x86_64.AppImageIf it doesn't start, install FUSE: sudo apt install libfuse2 (Ubuntu 24.04: libfuse2t64).
BreadPilot keeps its key in your keyring (GNOME Keyring or KWallet); without one it doesn't save an
OpenAI key.
Then: install Ollama for the free local AI, or add an OpenAI key
in ⚙ Settings.
Verify your download
shasum -a 256 -c SHA256SUMS.txt # macOS
sha256sum -c SHA256SUMS.txt # LinuxOn Windows (PowerShell), compare the result with the line in SHA256SUMS.txt:
Get-FileHash .\BreadPilot-0.2.0-Setup.exeKnown limitations
- The Intel Mac build hasn't been tested yet.
- Upgrading from 0.1.0: the web version's projects (Docker) aren't moved into the desktop app.
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.