Repository navigation
Voice Gateway 0.2.0 — multi-platform (5 of 6 binaries; mac-x64 deferred to #66)
Multi-platform release. Voice Gateway is now distributed for macOS, Windows, and Linux as installable binaries — Apple Silicon, Intel-Windows, ARM-Windows, x86_64-Linux, ARM-Linux. The macOS Intel (x64) binary is missing from this release because GitHub's macos-13 runner queue stalled at workflow time; tracked in issue #66.
What's new since v0.1.0
- 🆕 Multi-platform release pipeline — the new
release.ymlworkflow runs a 6-way matrix (mac arm64/x64 + win arm64/x64 + linux arm64/x64) on tag push and ships everything through a single GitHub Release. Seedocs/Build-And-Packaging.md. (PR #53) - 🛡 Build doctor pre-flight — catches a corrupted-
node_modulesfailure mode that's specific to external/exFAT-ish dev volumes. Surfaces a recovery command before the build wastes 6 s on a doomed run. (PR #49, issue #48) - ⚙️ Branch protection enforcement everywhere — pipeline V2 is now mandatory: issue → branch → PR → sub-agent review → CI green → squash-merge → tag → multi-platform release.
enforce_admins: true. (Internal pipeline work; tracked in issues #50, #52, #54, #65.) - 🤖 First card from the GitHub Project board — sub-issue decomposition + single PR pattern landed in CONTRIBUTING + framework wiki. (Issue #55, in-flight as PR #64.)
- 🔧 Tooling upgrades — Dependabot grouped patches:
actions/setup-python5→6,actions/configure-pages5→6,actions/upload-pages-artifact3→5,actions/checkout4→6,actions/upload-artifact4→7,electron-storepatch,electron-logpatch,lucide-reactpatch.
Install
Pick the build for your platform:
| Platform | Asset |
|---|---|
| macOS (Apple Silicon, M-series) | Voice Gateway-0.2.0-arm64.dmg |
| Windows (x64) | Voice Gateway Setup 0.2.0-x64.exe |
| Windows (ARM64) | Voice Gateway Setup 0.2.0-arm64.exe |
| Linux (x86_64) | Voice Gateway-0.2.0-x86_64.AppImage |
| Linux (ARM64) | Voice Gateway-0.2.0-aarch64.AppImage |
| macOS (Intel x64) | not in this release — see #66 |
After install:
- macOS: DMGs are ad-hoc signed. First launch needs the Gatekeeper override (Right-click → Open → Open the warning dialog).
- Windows: EXEs are unsigned (no Authenticode cert). SmartScreen will warn on first install; click "More info → Run anyway".
- Linux:
chmod +xthe AppImage if your file manager didn't do it.
Run the pairing wizard with your Hermes bridge URL + token. Pre-flight check in the wizard verifies the bridge before continuing.
SHA-256 checksums
e83cdd4dc324e6513dc755961d69b316247df80182d338eb6c8a1bbcc7795a62 Voice Gateway Setup 0.2.0-arm64.exe
335dca4ca71454ff8f8d540adc701b07a369d7374478acc50b6a0266936ff6b2 Voice Gateway Setup 0.2.0-x64.exe
bc3f59b00f1a8f6b4809a643e5daa2ba7381f138ab8f974b3d8dabfa0acaf41f Voice Gateway-0.2.0-aarch64.AppImage
652115cef0fbb67f1fd15c7ec3d0d02b7a0c90d5ca585ef9a8b8c37a93ecdf12 Voice Gateway-0.2.0-arm64.dmg
cc3b61efcb5726a9b63b4c269881415e324e8458c49ea109d05225d19b890fd9 Voice Gateway-0.2.0-x86_64.AppImage
Known limitations
- macOS Intel (x64) DMG missing from this release. The
macos-13runner queue stalled at workflow time (1h14m queued, never started). Issue #66 tracks the fix — likely switch to building mac-x64 frommacos-latestvia cross-compile or drop the target until Apple stops shipping Intel-supported macOS. - No Apple Developer ID signing → DMG triggers Gatekeeper on first launch.
- No Authenticode signing on the Windows EXEs → SmartScreen warning on first install.
- AppImage on Linux is unsigned; users can verify the SHA-256 above.
What's next
Tracked in open issues:
- #45 — coordinated upgrade: Vite 8 + Electron 39 +
@vitejs/plugin-react6 - #46 — React 19 migration
- #47 — Dependabot config: skip majors on locked packages
- #55 — multi-LLM integration (Claude / Ollama / Grok / ChatGPT) — in flight as PR #64 with sub-issues #56–#63
- #54 — V2 pipeline enforcement (auto-tag + Kanban hook)
- #66 — mac-x64 build fix
Thanks for trying it. Bug reports + feature requests welcome via Issues.