Skip to content

Add Linux support (AppImage) - #11

Merged
katipally merged 1 commit into
mainfrom
linux-support
Jul 18, 2026
Merged

Add Linux support (AppImage)#11
katipally merged 1 commit into
mainfrom
linux-support

Conversation

@katipally

@katipally katipally commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Adds a Linux build alongside macOS and Windows, plus CI coverage.

What

  • Linux AppImage (64-bit, unsigned) — download → chmod +x → run.
  • release.yml: ubuntu-latest added to the build matrix; Linux row in the download table.
  • ci.yml: a Linux build smoke test (install → typecheck → test → build unsigned AppImage), mirroring the existing Windows job — so every PR proves an AppImage builds on Ubuntu.
  • Scripts: build:linux / desktop:build:linux.
  • README download badge, RELEASING note, CHANGELOG 0.2.5.

Why it's low-risk

The only native dependency is sherpa-onnx-node. Its Linux prebuild (sherpa-onnx-linux-x64@1.13.4) already exists on npm, and pack-agent.cjs already had a linux-<arch> branch — the packing side was written Linux-aware from the start.

Verification

  • YAML valid, pnpm typecheck clean, pnpm test 77/77 pass locally.
  • The real Linux build proof is the new CI Linux job on ubuntu-latest — a Mac can't produce a correct Linux binary (pack bundles the host-OS sherpa addon).

Once CI is green here, tag v0.2.5 to cut the multi-platform release.

The one native piece — the sherpa-onnx voice-cloning addon — already has a
Linux branch in pack-agent.cjs, and sherpa-onnx-linux-x64 prebuilds exist on
npm, so the rest is wiring:

- electron-builder.yml: linux AppImage (x64) target, icon from build/icon.png
- release.yml: ubuntu-latest row in the build matrix + publish step + a Linux
  row in the release download table
- ci.yml: a Linux build smoke test (install → typecheck → test → build unsigned
  AppImage) mirroring the Windows job
- desktop + root package.json: build:linux / desktop:build:linux scripts
- README, RELEASING, CHANGELOG (0.2.5)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@katipally
katipally merged commit d47a673 into main Jul 18, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant