# Downloads & versions

URL: https://docs.bithuman.ai/downloads

> 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](https://docs.bithuman.ai/versions.json).

## Current versions

| Artifact | Version | Runs on | Install | Published at |
|---|---|---|---|---|
| [CLI](https://docs.bithuman.ai/platforms/cli) | **2.8.11** | macOS (Apple silicon), Linux x86_64 and arm64 | `curl -fsSL https://install.bithuman.ai \| sh` | [downloads.bithuman.ai cli-v2.8.11](https://docs.bithuman.ai/downloads#release-files) |
| [`bithuman` (Python)](https://docs.bithuman.ai/platforms/python) | **2.12.6** | Python 3.10–3.14 on macOS (Apple silicon), Linux x86_64 and arm64, Windows 11 x86_64 | `pip install "bithuman[expression-2]"` | [PyPI](https://pypi.org/project/bithuman/) |
| [Swift package](https://docs.bithuman.ai/platforms/ios) | **2.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](https://gitlab.com/bithuman/sdk/homebrew-bithuman/-/tags) |
| [`ai.bithuman:expression2-android`](https://docs.bithuman.ai/platforms/android) | **0.6.2** | Android, arm64-v8a | `implementation("ai.bithuman:expression2-android:0.6.2")` | [maven.bithuman.ai](https://maven.bithuman.ai/ai/bithuman/expression2-android/maven-metadata.xml) |
| [`ai.bithuman:essence2-android`](https://docs.bithuman.ai/platforms/android) | **0.10.3** | Android, arm64-v8a | `implementation("ai.bithuman:essence2-android:0.10.3")` | [maven.bithuman.ai](https://maven.bithuman.ai/ai/bithuman/essence2-android/maven-metadata.xml) |
| [`livekit-plugins-bithuman`](https://docs.bithuman.ai/platforms/livekit) | **1.8.7** | Python 3.10–3.14 | `pip install livekit-plugins-bithuman` | [PyPI](https://pypi.org/project/livekit-plugins-bithuman/) |
| [Flutter plugin](https://docs.bithuman.ai/platforms/flutter) | **2.6.40** | Android (arm64-v8a); iOS and macOS build from the published tag | `bithuman: {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](https://gitlab.com/bithuman/sdk/homebrew-bithuman/-/tags) |

The web embed needs no install: one URL or one `<iframe>` ([Web](https://docs.bithuman.ai/platforms/web)). The MCP server ships inside the CLI as `bithuman mcp` ([MCP server](https://docs.bithuman.ai/build/mcp)). What changed in each release is in the [changelog](https://docs.bithuman.ai/changelog).

## Supported operating systems

| Platform | CLI | Python | Swift package | Android |
|---|---|---|---|---|
| macOS, Apple silicon | yes | yes (macOS 14+) | yes | — |
| macOS, Intel | no | no | no | — |
| Linux x86_64 | yes | yes | — | — |
| Linux arm64 | yes | yes | — | — |
| Windows 10/11, x86_64 | yes: cloud sessions and MCP | yes (Windows 11, 2.11.18+; [Windows](https://docs.bithuman.ai/platforms/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](https://downloads.bithuman.ai/homebrew-bithuman/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](#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`.

| Release | File | Size |
|---|---|---|
| CLI 2.8.11 | [bithuman-aarch64-apple-darwin.tar.gz](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-aarch64-apple-darwin.tar.gz) · [sha256](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-aarch64-apple-darwin.tar.gz.sha256) | 242.4 MB |
| CLI 2.8.11 | [bithuman-aarch64-unknown-linux-gnu.tar.gz](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-aarch64-unknown-linux-gnu.tar.gz) · [sha256](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-aarch64-unknown-linux-gnu.tar.gz.sha256) | 183.3 MB |
| CLI 2.8.11 | [bithuman-x86_64-pc-windows-msvc.zip](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-x86_64-pc-windows-msvc.zip) · [sha256](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-x86_64-pc-windows-msvc.zip.sha256) | 24.5 MB |
| CLI 2.8.11 | [bithuman-x86_64-unknown-linux-gnu.tar.gz](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-x86_64-unknown-linux-gnu.tar.gz) · [sha256](https://downloads.bithuman.ai/homebrew-bithuman/cli-v2.8.11/bithuman-x86_64-unknown-linux-gnu.tar.gz.sha256) | 191.6 MB |

## Verify a download

The installer checks each tarball against the `.sha256` file published beside it ([Release files](#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:

```bash
# Linux
sha256sum -c bithuman-x86_64-unknown-linux-gnu.tar.gz.sha256
# macOS
shasum -a 256 -c bithuman-aarch64-apple-darwin.tar.gz.sha256
```

```powershell
# 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.