Metadata-Version: 2.1
Name: bithuman-cli
Version: 2.3.0
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.3.0
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.
