Description
livekit==1.1.3 fails to load liblivekit_ffi.so when running in a linux/arm64 Docker container based on Debian Bookworm (python:3.11-slim-bookworm). The native library references __arm_tpidr2_save, which is not available in the Bookworm glibc.
This is the same class of issue as AGT-2075 (glibc symbol incompatibility), but with a different symbol on arm64.
Environment
- Host: macOS on Apple Silicon (arm64)
- Docker image:
python:3.11-slim-bookworm (linux/arm64)
- livekit version: 1.1.3
- livekit-agents version: 1.5.1
Error
File "/workspace/.venv/lib/python3.11/site-packages/livekit/rtc/_ffi_client.py", line 228, in __init__
raise ImportError(
ImportError: failed to load liblivekit_ffi.so:
/workspace/.venv/lib/python3.11/site-packages/livekit/rtc/resources/liblivekit_ffi.so: undefined symbol: __arm_tpidr2_save
Install the livekit package with: pip install livekit
Or set LIVEKIT_LIB_PATH to the path of the native library.
Steps to reproduce
- On an Apple Silicon Mac, build a Docker image using
python:3.11-slim-bookworm as base (defaults to linux/arm64)
- Install
livekit==1.1.3
- Import livekit or run any command that triggers
FfiClient initialization
Workaround
Building with --platform linux/amd64 (x86 emulation via Rosetta) avoids the issue.