Skip to content

Releases

v0.2.0 Desktop App Release

Choose a tag to compare

@Prestical Prestical released this 03 Nov 05:50

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)

  1. Open the .dmg and drag BreadPilot into Applications.
  2. Open BreadPilot. macOS says it could not verify the app: click Done (not Move to Trash).
  3. Open System Settings → Privacy & Security and click Open Anyway next to BreadPilot.
  4. 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

  1. Run BreadPilot-0.2.0-Setup.exe and install (no administrator rights needed).
  2. 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.AppImage

If 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         # Linux

On Windows (PowerShell), compare the result with the line in SHA256SUMS.txt:

Get-FileHash .\BreadPilot-0.2.0-Setup.exe

Known 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

Choose a tag to compare

@Prestical Prestical released this 26 Oct 13:11

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 .uf2 with 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.