bithuman-cli 2.3.5__tar.gz

bithuman_cli-2.3.5/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.1
+Name: bithuman-cli
+Version: 2.3.5
+Summary: bitHuman CLI — `bithuman run model.imx` (live avatar) / `bithuman render` / `bithuman info` / `bithuman doctor`. Bundles the Rust CLI binary, the conversation brain, and the on-device plugins. Depends on the `bithuman` Python SDK.
+Keywords: bithuman,avatar,essence,lipsync,cli,livekit
+Author-Email: bitHuman <hello@bithuman.ai>
+License: Commercial — see LICENSE file
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia
+Project-URL: Homepage, https://bithuman.ai
+Project-URL: Documentation, https://docs.bithuman.ai
+Project-URL: Source, https://github.com/bithuman-product/bithuman-sdk
+Requires-Python: >=3.10
+Requires-Dist: bithuman<2.4,>=2.3.2
+Requires-Dist: livekit-agents[openai]==1.5.12
+Provides-Extra: local
+Requires-Dist: livekit-agents[silero]~=1.5; extra == "local"
+Requires-Dist: supertonic>=1.3; extra == "local"
+Requires-Dist: pywhispercpp>=1.3; extra == "local"
+Requires-Dist: llama-cpp-python>=0.3; extra == "local"
+Requires-Dist: soxr>=0.5; extra == "local"
+Description-Content-Type: text/markdown
+
+# bithuman-cli
+
+The bitHuman CLI tool — `bithuman run`, `bithuman render`,
+`bithuman doctor`, `bithuman info`, `bithuman list`, `bithuman pull`.
+
+Bundles:
+
+- The cross-platform Rust CLI binary (`bithuman_cli/_bin/bithuman`)
+- The conversation brain (`agent.py`) spawned by `bithuman run`
+- On-device brain plugins (whisper.cpp + llama.cpp + Supertonic) under
+  the `[local]` extra
+- The `livekit-server` Go SFU child that the CLI spawns to host the
+  in-browser talk loop
+
+Depends on the [`bithuman`](https://pypi.org/project/bithuman/) Python
+SDK for the in-process avatar runtime.
+
+## Install
+
+```sh
+pip install bithuman-cli                   # cloud brain (OpenAI Realtime)
+pip install 'bithuman-cli[local]'          # also bundles on-device brain
+```
+
+For non-Python install paths (the same Rust binary, no Python needed):
+
+```sh
+brew install bithuman                                # macOS
+curl -fsSL https://install.bithuman.ai | sh          # macOS / Linux
+```
+
+## Usage
+
+```sh
+bithuman run model.imx          # live avatar via LiveKit, browser-to-talk
+bithuman render model.imx -a in.wav -o out.mp4    # offline mp4
+bithuman doctor                  # check install + env + brain config
+```
+
+See [docs.bithuman.ai](https://docs.bithuman.ai) for the full reference.

bithuman_cli-2.3.5/README.md

@@ -0,0 +1,40 @@
+# bithuman-cli
+
+The bitHuman CLI tool — `bithuman run`, `bithuman render`,
+`bithuman doctor`, `bithuman info`, `bithuman list`, `bithuman pull`.
+
+Bundles:
+
+- The cross-platform Rust CLI binary (`bithuman_cli/_bin/bithuman`)
+- The conversation brain (`agent.py`) spawned by `bithuman run`
+- On-device brain plugins (whisper.cpp + llama.cpp + Supertonic) under
+  the `[local]` extra
+- The `livekit-server` Go SFU child that the CLI spawns to host the
+  in-browser talk loop
+
+Depends on the [`bithuman`](https://pypi.org/project/bithuman/) Python
+SDK for the in-process avatar runtime.
+
+## Install
+
+```sh
+pip install bithuman-cli                   # cloud brain (OpenAI Realtime)
+pip install 'bithuman-cli[local]'          # also bundles on-device brain
+```
+
+For non-Python install paths (the same Rust binary, no Python needed):
+
+```sh
+brew install bithuman                                # macOS
+curl -fsSL https://install.bithuman.ai | sh          # macOS / Linux
+```
+
+## Usage
+
+```sh
+bithuman run model.imx          # live avatar via LiveKit, browser-to-talk
+bithuman render model.imx -a in.wav -o out.mp4    # offline mp4
+bithuman doctor                  # check install + env + brain config
+```
+
+See [docs.bithuman.ai](https://docs.bithuman.ai) for the full reference.

bithuman_cli-2.3.5/pyproject.toml

@@ -0,0 +1,113 @@
+# bithuman-cli — the bitHuman CLI wheel.
+#
+# Phase B split (2026-05-28): the CLI surface (`bithuman run / render /
+# doctor`) was extracted from the unified `bithuman` PyPI package into
+# this dedicated wheel. The `bithuman` console script now lives here;
+# the `bithuman` PyPI package is the slim Python SDK
+# (`from bithuman import AsyncBithuman`) that this wheel depends on.
+#
+# What this wheel ships:
+#   bithuman_cli/_bin/bithuman          — Rust CLI binary (per-platform)
+#   bithuman_cli/_bin/lib/*.dylib|so    — vendored native deps
+#   bithuman_cli/_bin/livekit-server    — Go SFU child the CLI spawns
+#   bithuman_cli/_entry.py              — Python shim, exec's _bin/bithuman
+#   bithuman_cli/agent.py               — conversation brain (livekit-agents)
+#   bithuman_cli/local_plugins/         — on-device STT/LLM/TTS (under [local])
+#
+# pure-Python wheel — no C extension. The Rust binary is staged into
+# bithuman_cli/_bin/ at wheel-build time by the CI workflow; scikit-build-
+# core copies it (and any tree-under-src content) into the wheel
+# automatically via the `wheel.packages` config below.
+
+[build-system]
+requires = ["scikit-build-core>=0.10"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "bithuman-cli"
+version = "2.3.5"
+description = "bitHuman CLI — `bithuman run model.imx` (live avatar) / `bithuman render` / `bithuman info` / `bithuman doctor`. Bundles the Rust CLI binary, the conversation brain, and the on-device plugins. Depends on the `bithuman` Python SDK."
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "bitHuman", email = "hello@bithuman.ai" }]
+license = { text = "Commercial — see LICENSE file" }
+keywords = ["bithuman", "avatar", "essence", "lipsync", "cli", "livekit"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Multimedia",
+]
+
+# Phase B split: the CLI depends on the slim `bithuman` SDK wheel for the
+# in-process avatar runtime. The slim SDK is on its own (decoupled)
+# semver track — it does NOT move in lockstep with the CLI version — so
+# pin to a compatible RANGE (>= the version this CLI was built against,
+# < the next minor), not an exact match that goes stale the moment the
+# SDK ships a patch. (It did: the CLI was 2.3.0 but the slim SDK is now
+# 2.3.2, so `==2.3.0` pulled a stale SDK.)
+#
+# `livekit-plugins-bithuman` is intentionally NOT a runtime dep. Its
+# `bithuman<1.12` pin would block our 2.x SDK install. The cloud-mode
+# `AvatarSession` we use is reimplemented inline in
+# `bithuman_cli/_avatar_bridge.py` on top of livekit-agents primitives
+# (`AvatarSession` base + `DataStreamAudioOutput` + `ATTRIBUTE_PUBLISH_ON_BEHALF`).
+# Users who want the in-process `BITHUMAN_LOCAL_AVATAR=1` path can
+# `pip install livekit-plugins-bithuman` themselves — the import is
+# lazy in `agent.py`. Sunset: drop `_avatar_bridge.py` and re-add the
+# dep once upstream relaxes `bithuman<1.12`.
+dependencies = [
+    "bithuman>=2.3.2,<2.4",
+    "livekit-agents[openai]==1.5.12",
+]
+
+# Fully on-device brain for `BITHUMAN_LOCAL=1 bithuman run` — no API
+# keys. whisper.cpp STT, llama.cpp LLM, Supertonic TTS, all in-process
+# and mobile-portable (same C++ cores run on iOS/Android). Models
+# auto-download from HuggingFace to ~/.cache/{huggingface,supertonic}
+# on first use.
+[project.optional-dependencies]
+local = [
+    "livekit-agents[silero]~=1.5",
+    "supertonic>=1.3",
+    "pywhispercpp>=1.3",
+    "llama-cpp-python>=0.3",
+    "soxr>=0.5",
+]
+
+[project.scripts]
+# The `bithuman` console script lives here in 2.2.7+. The entry shim
+# (`bithuman_cli._entry:main`) locates `_bin/bithuman` (the Rust binary
+# staged at wheel-build time) and `execvpe`s into it, setting env vars
+# so the Rust binary's `embedded_agent_worker` finds this wheel's
+# `agent.py` + the venv's Python interpreter.
+bithuman = "bithuman_cli._entry:main"
+
+[project.urls]
+Homepage = "https://bithuman.ai"
+Documentation = "https://docs.bithuman.ai"
+Source = "https://github.com/bithuman-product/bithuman-sdk"
+
+[tool.scikit-build]
+minimum-version = "0.10"
+build-dir = "build/{wheel_tag}"
+# Pure-Python wheel — no CMake C extension to build. scikit-build-core
+# still copies the ENTIRE package directory tree (every file, not just
+# *.py) into the wheel, so the staged `_bin/bithuman` + dylib closure
+# + livekit-server + agent.py + local_plugins/ all ride along
+# automatically.
+wheel.packages = ["src/bithuman_cli"]
+# Explicit: never exclude anything from the copied package tree.
+wheel.exclude = []
+# Pure-Python wheel: no CMakeLists.txt to run. Without this, scikit-
+# build-core 0.10+ unconditionally tries to invoke CMake and fails the
+# build with "source directory does not contain CMakeLists.txt".
+wheel.cmake = false

bithuman_cli-2.3.5/scripts/build-cli-wheel-in-container.sh

@@ -0,0 +1,240 @@
+#!/usr/bin/env bash
+# Build the `bithuman-cli` wheel inside the libessence/manylinux-x86_64
+# (or aarch64) image. Phase B split (2026-05-28): produces the slim,
+# pure-Python `bithuman-cli` wheel; the C-extension `bithuman` SDK
+# wheel is built by the SDK repo's
+# `bithuman-sdk/sdks/python/scripts/build-wheel-in-container.sh`.
+#
+# Wave 11 in-container layout (the caller — cli/scripts/build-linux.sh
+# or the cli-release workflow — hardlinks both checkouts under /src to
+# satisfy these legacy paths):
+#   /src/cpp                       — libessence cmake src (bithuman-sdk/engine)
+#   /src/cpp/bindings/rust         — cargo workspace (bithuman-apps/cli)
+#   /src/cpp/bindings/python       — SDK Python (bithuman-sdk/sdks/python)
+#   /src/cpp/bindings/python-cli   — this wheel src (bithuman-apps/cli/wheel)
+#
+# Env:
+#   PYTAG               cp311 (default) / cp310 / cp312 / cp313 / cp314
+#   ARCH_INSIDE         x86_64 (default) / aarch64
+#
+# What this produces:
+#   cli/wheel/dist/bithuman_cli-<ver>-*-manylinux_2_28_*.whl
+#
+# Wheel contents (staged BEFORE `python -m build`):
+#   bithuman_cli/_bin/bithuman           — Rust CLI binary
+#   bithuman_cli/_bin/lib/*.so*          — vendored ldd closure
+#   bithuman_cli/_bin/livekit-server     — Go SFU child
+#   bithuman_cli/_entry.py               — entry shim
+#   bithuman_cli/agent.py                — embedded conversation brain
+#   bithuman_cli/local_plugins/          — on-device STT/LLM/TTS
+#
+# Pure-Python wheel — no auditwheel repair needed (the binary is
+# already self-contained: cargo + RPATH=$ORIGIN/lib). We DO NOT run
+# auditwheel here: it would reject the Rust binary's newer-than-
+# manylinux_2_28 glibc symbol versions.
+
+set -euo pipefail
+
+PYTAG="${PYTAG:-cp311}"
+ARCH_INSIDE="${ARCH_INSIDE:-x86_64}"
+
+echo "== bithuman-cli wheel build =="
+echo "   python:           $PYTAG"
+echo "   arch:             $ARCH_INSIDE"
+echo "   gcc:              $(gcc --version | head -1)"
+
+# Phase 4b §3.3 rationale (carried over): the cmake/cargo path that
+# builds libessence.a (for the binary's link) must use the same Rust
+# toolchain as the binary's cargo invocation, or two libstd copies
+# end up in the link → duplicate-symbol error from rust-lld. Refresh
+# the toolchain BEFORE cmake.
+export PATH="/root/.cargo/bin:${PATH}"
+if ! ldconfig -p | grep -q libclang.so; then
+    echo "::error::libclang not in the image — rebuild the manylinux container"
+    echo "  docker build --platform linux/${ARCH_INSIDE/x86_64/amd64} -t libessence/manylinux-${ARCH_INSIDE}:0.1 -f bithuman-sdk/sdks/python/scripts/Dockerfile.manylinux-${ARCH_INSIDE} bithuman-sdk/sdks/python/scripts/"
+    exit 1
+fi
+echo "==> rustup update stable (pre-cmake — keep one libstd across all cargo invocations)"
+rustup update stable 2>&1 | tail -3
+rustup default stable
+
+cd /src/cpp
+BUILD_LINUX_DIR="build-linux-${ARCH_INSIDE}"
+# 1. Build libessence_core for Linux — same as the SDK-wheel container
+#    script. The Rust bithuman-cli binary links libbithuman_imx.a
+#    against libessence.a.
+cmake -GNinja -B "$BUILD_LINUX_DIR" -S . -DCMAKE_BUILD_TYPE=Release \
+    -DCMAKE_POSITION_INDEPENDENT_CODE=ON \
+    -DONNX_RUNTIME_DIR=/opt/bes-deps \
+    -DCMAKE_PREFIX_PATH="/opt/bes-deps;/usr/local"
+cmake --build "$BUILD_LINUX_DIR" --target essence -j"$(nproc)"
+ls -la "$BUILD_LINUX_DIR/libessence.a"
+
+# 2. Stage the Rust CLI binary + dylib closure + livekit-server into the
+#    bithuman-cli wheel source tree.
+echo
+echo "== STAGE BUNDLED CLI =="
+echo "   cargo:    $(cargo --version)"
+echo "   rustc:    $(rustc --version)"
+
+export ESSENCE_BUILD_DIR="/src/cpp/${BUILD_LINUX_DIR}"
+export CARGO_TARGET_DIR="/src/cpp/bindings/rust/target-linux-${ARCH_INSIDE}"
+
+# bindgen + espeak-rs-sys: see build-linux-in-container.sh for the
+# long rationale on libclang path + pthread linker flag seeding.
+export LIBCLANG_PATH="${LIBCLANG_PATH:-/usr/lib64}"
+export LDFLAGS="${LDFLAGS:-} -pthread"
+export CFLAGS="${CFLAGS:-} -pthread"
+export CXXFLAGS="${CXXFLAGS:-} -pthread"
+
+LINK_RPATHS=(
+    "-C" "link-arg=-Wl,-rpath,/opt/bes-deps/lib"
+    "-C" "link-arg=-Wl,-rpath,/opt/bes-deps/lib64"
+    "-C" "link-arg=-Wl,-rpath,/usr/local/lib"
+    "-C" "link-arg=-Wl,-rpath,/usr/local/lib64"
+    "-C" "link-arg=-Wl,-rpath,/usr/lib64"
+    "-C" "link-arg=-Wl,-rpath,\$ORIGIN"
+    "-C" "link-arg=-Wl,-rpath,\$ORIGIN/lib"
+    "-C" "link-arg=-static-libgcc"
+)
+export RUSTFLAGS="${RUSTFLAGS:-} ${LINK_RPATHS[*]}"
+
+cd /src/cpp/bindings/rust
+cargo clean -p espeak-rs-sys 2>/dev/null || true
+# Phase A: the binary crate is `bithuman-cli` (was `bithuman` pre-rename).
+cargo build --release -p bithuman-cli
+
+BIN_SRC="$CARGO_TARGET_DIR/release/bithuman"
+[ -f "$BIN_SRC" ] || { echo "cargo built no binary at $BIN_SRC"; exit 1; }
+strip --strip-all "$BIN_SRC" 2>/dev/null || true
+
+# Stage _bin/ into the CLI wheel package.
+CLI_PKG_DIR="/src/cpp/bindings/python-cli/src/bithuman_cli"
+BIN_STAGE="$CLI_PKG_DIR/_bin"
+rm -rf "$BIN_STAGE/lib"
+mkdir -p "$BIN_STAGE/lib"
+cp "$BIN_SRC" "$BIN_STAGE/bithuman"
+chmod +x "$BIN_STAGE/bithuman"
+
+# Recursive ldd closure — auditwheel manylinux_2_28 baseline.
+BASELINE_SONAMES=" libc.so.6 libm.so.6 libdl.so.2 librt.so.1 libpthread.so.0 libgcc_s.so.1 libstdc++.so.6 libgomp.so.1 libz.so.1 ld-linux-x86-64.so.2 ld-linux-aarch64.so.1 "
+is_baseline() { case " $BASELINE_SONAMES " in *" $1 "*) return 0 ;; *) return 1 ;; esac; }
+declare -A SEEN
+_collect_iter() {
+    while read -r line; do
+        local soname path
+        if [[ "$line" == *"=>"* ]]; then
+            soname="${line%% =>*}"; soname="${soname##*[[:space:]]}"
+            path="${line#*=> }"; path="${path%% (0x*}"; path="${path%% }"
+        else
+            path="${line%% (0x*}"; path="$(echo "$path" | xargs 2>/dev/null || true)"
+            soname="$(basename "$path" 2>/dev/null || true)"
+        fi
+        [[ -z "${path:-}" || ! -f "$path" ]] && continue
+        case "$soname" in linux-vdso.so*|ld-linux*) continue ;; esac
+        is_baseline "$soname" && continue
+        if [[ -z "${SEEN[$soname]:-}" ]]; then
+            SEEN[$soname]=1
+            cp -L "$path" "$BIN_STAGE/lib/$soname"
+            chmod u+w "$BIN_STAGE/lib/$soname"
+            _collect_iter < <(ldd "$path" 2>/dev/null || true)
+        fi
+    done
+}
+_collect_iter < <(ldd "$BIN_SRC" 2>/dev/null)
+BUNDLED_COUNT="$(ls -1 "$BIN_STAGE/lib" | wc -l | tr -d ' ')"
+echo "   bundled $BUNDLED_COUNT shared libs into _bin/lib/"
+[[ "$BUNDLED_COUNT" -lt 5 ]] && { echo "::error::suspiciously small dep closure ($BUNDLED_COUNT)"; exit 1; }
+
+patchelf --set-rpath '$ORIGIN/lib' "$BIN_STAGE/bithuman"
+for so in "$BIN_STAGE/lib"/*; do
+    patchelf --set-rpath '$ORIGIN' "$so" 2>/dev/null || true
+done
+
+# audio_encoder.onnx — RUNTIME asset, sourced from the SDK wheel tree.
+cp /src/cpp/bindings/python/src/bithuman/lib/audio_encoder.onnx "$BIN_STAGE/lib/audio_encoder.onnx"
+
+# livekit-server (Go SFU). Same source-priority logic as the SDK wheel
+# script (see history in bithuman-sdk/sdks/python/scripts/build-wheel-
+# in-container.sh).
+LK_VER="${BITHUMAN_LIVEKIT_SERVER_VER:-1.12.0}"
+case "$ARCH_INSIDE" in
+    x86_64)  LK_ARCH=linux_amd64 ;;
+    aarch64) LK_ARCH=linux_arm64 ;;
+    *) echo "::error::unknown ARCH_INSIDE=$ARCH_INSIDE"; exit 1 ;;
+esac
+if [[ -n "${BITHUMAN_LIVEKIT_SERVER_URL:-}" ]]; then
+    echo "   fetching livekit-server from override URL: $BITHUMAN_LIVEKIT_SERVER_URL"
+    curl -fsSL "$BITHUMAN_LIVEKIT_SERVER_URL" -o /tmp/livekit.tar.gz
+elif [[ "${BITHUMAN_LIVEKIT_SERVER_MIRROR:-0}" == "1" ]]; then
+    echo "   fetching livekit-server v${LK_VER} ${LK_ARCH} from bithuman mirror"
+    if command -v gh >/dev/null 2>&1 && gh auth status >/dev/null 2>&1; then
+        mkdir -p /tmp/lk-mirror && cd /tmp/lk-mirror
+        gh release download "livekit-server-mirror-v${LK_VER}" \
+            --repo bithuman-product/bithuman-sdk \
+            --pattern "livekit_${LK_VER}_${LK_ARCH}.tar.gz" \
+            --clobber
+        mv "livekit_${LK_VER}_${LK_ARCH}.tar.gz" /tmp/livekit.tar.gz
+        cd - >/dev/null
+    else
+        echo "::error::mirror fetch needs gh-cli (preferred) or GH_TOKEN/GITHUB_TOKEN env" >&2
+        echo "  set BITHUMAN_LIVEKIT_SERVER_URL to bypass, or unset BITHUMAN_LIVEKIT_SERVER_MIRROR." >&2
+        exit 1
+    fi
+else
+    LK_URL="https://github.com/livekit/livekit/releases/download/v${LK_VER}/livekit_${LK_VER}_${LK_ARCH}.tar.gz"
+    echo "   fetching livekit-server v${LK_VER} ${LK_ARCH} from upstream"
+    curl -fsSL "$LK_URL" -o /tmp/livekit.tar.gz
+fi
+mkdir -p /tmp/lk-extract
+tar -xzf /tmp/livekit.tar.gz -C /tmp/lk-extract
+LK_BIN="$(find /tmp/lk-extract -name livekit-server -type f -executable | head -1)"
+[ -n "$LK_BIN" ] || { echo "::error::livekit-server not in archive"; ls -la /tmp/lk-extract; exit 1; }
+cp "$LK_BIN" "$BIN_STAGE/livekit-server"
+chmod +x "$BIN_STAGE/livekit-server"
+rm -rf /tmp/lk-extract /tmp/livekit.tar.gz
+
+# 3. Build the wheel — pure Python, no scikit-build CMake step.
+cd /src/cpp/bindings/python-cli
+PY="/opt/python/${PYTAG}-${PYTAG}/bin/python"
+"$PY" -m pip install --quiet --upgrade pip build scikit-build-core
+mkdir -p dist
+rm -f dist/bithuman_cli-*-${PYTAG}-${PYTAG}-*${ARCH_INSIDE}*.whl
+"$PY" -m build --wheel --outdir dist/
+
+WHL=$(ls dist/bithuman_cli-*-${PYTAG}-${PYTAG}-linux_${ARCH_INSIDE}.whl 2>/dev/null | head -1)
+[ -n "$WHL" ] || { echo "no raw wheel produced"; ls dist/; exit 1; }
+echo
+echo "== raw wheel =="
+ls -la "$WHL"
+
+# 4. Rename to manylinux_2_28 (no auditwheel — the binary is already
+#    self-contained, and auditwheel would reject the rust-lld glibc
+#    symbol versions). Just relabel the platform tag.
+REPAIRED="${WHL/linux_${ARCH_INSIDE}/manylinux_2_28_${ARCH_INSIDE}}"
+mv "$WHL" "$REPAIRED"
+echo "  -> $REPAIRED"
+ls -lh "$REPAIRED"
+
+# 5. Smoke test inside a clean venv.
+echo
+echo "== smoke test =="
+"$PY" -m venv /tmp/smoke-cli
+# bithuman-cli depends on bithuman (the SDK wheel). The SDK wheel
+# might or might not be available locally — try a sibling dist/, else
+# just install bithuman-cli on its own (pip will resolve the dep from
+# the local index if present or from PyPI).
+SDK_DIST="/src/cpp/bindings/python/dist"
+if ls "$SDK_DIST"/bithuman-*-${PYTAG}-${PYTAG}-manylinux_2_28_${ARCH_INSIDE}.whl >/dev/null 2>&1; then
+    /tmp/smoke-cli/bin/pip install --quiet \
+        "$SDK_DIST"/bithuman-*-${PYTAG}-${PYTAG}-manylinux_2_28_${ARCH_INSIDE}.whl \
+        "$REPAIRED"
+else
+    echo "  (no sibling SDK wheel — installing bithuman-cli alone; bithuman dep resolved from PyPI/index)"
+    /tmp/smoke-cli/bin/pip install --quiet "$REPAIRED"
+fi
+/tmp/smoke-cli/bin/bithuman --version
+/tmp/smoke-cli/bin/bithuman --help | head -5
+
+echo
+echo "DONE — wheel at: $REPAIRED"

bithuman_cli-2.3.5/src/bithuman_cli/__init__.py

@@ -0,0 +1,22 @@
+"""bithuman-cli — the bitHuman command-line tool.
+
+Internal package. Users interact via the `bithuman` console script
+installed by this wheel:
+
+    bithuman run model.imx        # live avatar
+    bithuman render -a in.wav -o out.mp4
+    bithuman doctor
+
+Programmatic invocation is also supported:
+
+    python -m bithuman_cli  # equivalent to running `bithuman`
+
+For embedding the bitHuman runtime in a Python application, use the
+bitHuman SDK directly (this wheel depends on it):
+
+    from bithuman import AsyncBithuman
+"""
+from __future__ import annotations
+
+# Keep aligned with cpp/bindings/python-cli/pyproject.toml.
+__version__ = "2.3.0"

bithuman_cli-2.3.5/src/bithuman_cli/__main__.py

@@ -0,0 +1,12 @@
+"""bithuman-cli module entry: `python -m bithuman_cli <command>`.
+
+Equivalent to running the `bithuman` console script installed by this
+wheel — both call `bithuman_cli._entry:main`, which locates the
+bundled Rust binary at `bithuman_cli/_bin/bithuman` and `execvpe`s
+into it.
+"""
+import sys
+
+from ._entry import main
+
+sys.exit(main())