Developer templates & examples

Copy-paste starters for building AI avatars with the bitHuman SDK and REST API.

Free · no account needed

Render your first avatar in ~60 seconds

The quickstart auto-downloads a sample avatar model on first run — no API key, no credits, no account.

pip install bithuman
python local-avatar.py   # downloads a 112 MB sample model on first run

Open the quickstart →Get an API key (for your own avatars)

Start here

Local avatar quickstart

Free

Load an avatar, push audio, see the animated face. Auto-downloads a sample model — no account or credits needed.

PythonNo account

Cloud avatar quickstart

Drive a hosted avatar over LiveKit with your API secret and an agent ID.

PythonCloud

Python SDK

Local Essence

Run the Essence model on any CPU, fully self-hosted.

PythonSelf-hosted

Cloud Essence

Call the cloud-hosted Essence runtime from Python.

PythonCloud

REST API

curl

Hit the REST API straight from the shell — generate, speak, poll status.

curlREST

Python (REST)

Drive the REST API with the requests library.

PythonREST

Web & app integrations

Next.js UI

A full-stack Next.js front end wired to a bitHuman avatar — clone and ship.

Next.jsTypeScript

Gradio web demo

In-browser avatar demo with a Gradio UI.

PythonGradio

Java WebSocket

Stream frames to a Java client over WebSocket.

JavaWebSocket

Offline (macOS)

Fully on-device avatar on Apple Silicon, no network.

macOSOn-device

Swift / Apple

iOS avatar

Embed a live avatar in an iOS app.

SwiftiOS

macOS avatar

Native macOS avatar playback.

SwiftmacOS

macOS voice

Voice-driven avatar on macOS.

SwiftmacOS

CLI

CLI recipes

Render video, live-stream, and call the REST API — all from shell scripts.

CLIBash

Ready to build your own?

Create a free account (99 credits, no card) and grab an API key.

Create free account Read the docs