Skip to content

v1.2.1 — Portable binary distribution, docs#2

Merged
skitsanos merged 3 commits intomainfrom
develop
Mar 16, 2026
Merged

v1.2.1 — Portable binary distribution, docs#2
skitsanos merged 3 commits intomainfrom
develop

Conversation

@skitsanos
Copy link
Member

Summary

Patch release fixing binary portability and adding distribution documentation.

Fixes

  • Portable rpath — Binary now uses @executable_path/lib (macOS) and $ORIGIN/lib (Linux) instead of hardcoded absolute build paths. Enables deploying the binary to other machines with dylibs in lib/ next to it.

Documentation

  • Added "Binary distribution" section to README with directory layout and build commands
  • Added dylib troubleshooting guide for Library not loaded errors

Test plan

  • 28 tests pass
  • Zero clippy warnings
  • Portable binary tested on a separate machine

skitsanos added 3 commits March 16, 2026 14:51
Embed @executable_path/lib and @executable_path rpaths so the binary
finds sherpa-onnx dylibs relative to itself, not hardcoded to the
build machine path. Enables portable distribution as:
  transcribeit (binary)
  lib/libsherpa-onnx-c-api.dylib
  lib/libonnxruntime.dylib

Linux uses $ORIGIN/lib and $ORIGIN equivalents.
@skitsanos skitsanos merged commit 5c667e4 into main Mar 16, 2026
6 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