Docs index: /llms.txt · every page as Markdown: add .md

‹ Overview

Downloads & versions

The current version and install line of every bitHuman artifact.

Every bitHuman artifact at its current release. The same data is published as JSON for scripts and agents at /versions.json.

Current versions

ArtifactVersionRuns onInstallPublished at
CLI2.8.11macOS (Apple silicon), Linux x86_64 and arm64curl -fsSL https://install.bithuman.ai | shdownloads.bithuman.ai cli-v2.8.11
bithuman (Python)2.12.6Python 3.10–3.14 on macOS (Apple silicon), Linux x86_64 and arm64, Windows 11 x86_64pip install "bithuman[expression-2]"PyPI
Swift package2.22.1 (Essence 2 engine 1.0.6 · Expression 2 engine 2.20.7)iOS, iPadOS and macOS on Apple silicon.package(url: "https://gitlab.com/bithuman/sdk/homebrew-bithuman", from: "2.22.1")GitLab tag v2.22.1
ai.bithuman:expression2-android0.6.2Android, arm64-v8aimplementation("ai.bithuman:expression2-android:0.6.2")maven.bithuman.ai
ai.bithuman:essence2-android0.10.3Android, arm64-v8aimplementation("ai.bithuman:essence2-android:0.10.3")maven.bithuman.ai
livekit-plugins-bithuman1.8.7Python 3.10–3.14pip install livekit-plugins-bithumanPyPI
Flutter plugin2.6.40Android (arm64-v8a); iOS and macOS build from the published tagbithuman: {git: {url: https://gitlab.com/bithuman/sdk/homebrew-bithuman.git, path: packages/flutter-plugin, ref: flutter-plugin-v2.6.40}}GitLab tag flutter-plugin-v2.6.40

The web embed needs no install: one URL or one <iframe> (Web). The MCP server ships inside the CLI as bithuman mcp (MCP server). What changed in each release is in the changelog.

Supported operating systems

PlatformCLIPythonSwift packageAndroid
macOS, Apple siliconyesyes (macOS 14+)yes—
macOS, Intelnonono—
Linux x86_64yesyes——
Linux arm64yesyes——
Windows 10/11, x86_64yes: cloud sessions and MCPyes (Windows 11, 2.11.18+; Windows)——
iOS / iPadOS——yes—
Android (arm64-v8a)———yes

On Windows, install the CLI from PowerShell with irm https://install.bithuman.ai/windows | iex: it checks the download against its published SHA256, installs bithuman.exe into %LOCALAPPDATA%\bithuman\bin and adds that folder to your PATH.

On an unsupported platform the CLI installer names the platform and stops, and pip install bithuman finds no wheel. Neither installs anything.

The CLI is not on PyPI. The only bitHuman package on PyPI with the bithuman name is the Python library, and it installs no command. Get the CLI from the installer or the Homebrew formula bithuman-cli.

Release files

The files of the current CLI release, each with its .sha256 file. Every release published on downloads.bithuman.ai is listed with its files in releases.json, in GitHub’s release format.

If curl -fsSL https://install.bithuman.ai | sh cannot run on your machine, download the file for your machine below, check it as in Verify a download, unpack it and put bithuman on your PATH. On a Mac, Homebrew works too: brew tap bithuman/bithuman https://gitlab.com/bithuman/sdk/homebrew-bithuman && brew install bithuman/bithuman/bithuman-cli.

Verify a download

The installer checks each tarball against the .sha256 file published beside it (Release files), prints sha256 ok, and stops on a mismatch. To check a tarball you downloaded yourself, put the .sha256 file next to it and run:

# Linux
sha256sum -c bithuman-x86_64-unknown-linux-gnu.tar.gz.sha256
# macOS
shasum -a 256 -c bithuman-aarch64-apple-darwin.tar.gz.sha256
# Windows (PowerShell): compare with the hash in the .sha256 file
(Get-FileHash bithuman-x86_64-pc-windows-msvc.zip -Algorithm SHA256).Hash

The Windows build isn’t code-signed. If you download the .zip from the browser, SmartScreen may ask you to confirm (More info → Run anyway). The install script avoids this. Verify with the published SHA256.

pip verifies the Python wheel against the digest PyPI publishes.