Skip to content

fix(ipc): hint about missing Git LFS on prewarm init failure#6044

Open
kamalmostafa wants to merge 1 commit into
livekit:mainfrom
kamalmostafa:kamalmostafa/add-git-lfs-hint
Open

fix(ipc): hint about missing Git LFS on prewarm init failure#6044
kamalmostafa wants to merge 1 commit into
livekit:mainfrom
kamalmostafa:kamalmostafa/add-git-lfs-hint

Conversation

@kamalmostafa

Copy link
Copy Markdown

If the repo is cloned without Git LFS, the LFS-tracked assets (e.g. the Silero VAD model) are left as pointer placeholder files. This breaks even the basic examples, which crash with a cryptic error, e.g.

onnxruntime.capi.onnxruntime_pybind11_state.InvalidProtobuf: [ONNXRuntimeError] : 7 : INVALID_PROTOBUF : Load model from .../livekit-plugins/livekit-plugins-silero/livekit/plugins/silero/resources/silero_vad.onnx failed:Protobuf parsing failed.

Wrap the prewarm/init failure in _ProcClient.initialize() to append a hint suggesting the repo may have been cloned without Git LFS and instructions to resolve. Also document the Git LFS requirement in the README dev setup section.

Fixes #6043

@CLAassistant

CLAassistant commented Jun 10, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 2 additional findings.

Open in Devin Review

If the repo is cloned without Git LFS, the LFS-tracked assets (e.g. the Silero
VAD model) are left as pointer placeholder files.  This breaks even the
basic examples, which crash with a cryptic error, e.g.

onnxruntime.capi.onnxruntime_pybind11_state.InvalidProtobuf: [ONNXRuntimeError] : 7 : INVALID_PROTOBUF : Load model from .../livekit-plugins/livekit-plugins-silero/livekit/plugins/silero/resources/silero_vad.onnx failed:Protobuf parsing failed.

Wrap the prewarm/init failure in _ProcClient.initialize() to append a
hint suggesting the repo may have been cloned without Git LFS and
instructions to resolve.  Also document the Git LFS requirement in the
README dev setup section.

Fixes livekit#6043

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@kamalmostafa kamalmostafa force-pushed the kamalmostafa/add-git-lfs-hint branch from b72e402 to 7552644 Compare June 11, 2026 14:02
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.

Basic examples fail with opaque error, if repo is cloned without git-lfs installed

2 participants