Get started

Your first visual agent

A real-time avatar that sees, hears, and talks back. See one work right now with no setup — then choose how you want to run your own.

1

See one work — no setup

Pick an agent and hit Launch to talk to a live avatar in your browser. No account, no install.

Agent
Model
embed.html
Energetic Audio Story Buddy
Press Launch to talk to a live agent

Want it on your own site? Drop in one <iframe> — it needs no API key:

<!-- Paste into any page. No API key, no install. -->
<iframe
  src="https://bithuman.ai/embed/A78WKV4515"
  width="400" height="600"
  allow="microphone; autoplay"
  style="border:0;border-radius:16px">
</iframe>
2

Choose how you run it

There's only one real decision: let us host it, or run it on your own hardware. You can switch later — it's the same engine and the same avatars either way.

Cloud

Use the cloud API

We host the GPU. Call simple REST endpoints to generate, host, and drive avatars. Best for web apps and zero-ops backends.

  • No infrastructure to run
  • Works from any language over HTTP
Start with the API →
On-device

Run it yourself (SDK)

Run avatars on your own hardware — Python, Swift, Android, the browser, or a single CLI command. Private, low-latency, offline-capable.

  • Your machine, your data
  • Python · Swift · Web · CLI
Get the SDK →

Not sure? Most people start on-device — it's three commands to a talking avatar in your browser:

# 1 · install (Homebrew or the universal installer)
curl -fsSL https://raw.githubusercontent.com/bithuman-product/homebrew-bithuman/main/install.sh | sh

# 2 · sign in (opens your browser)
bithuman login

# 3 · grab an avatar and run it
bithuman pull modern-court-jester
bithuman run ~/.cache/bithuman/showcase/modern-court-jester.imx
# → open the printed http://127.0.0.1:8088 URL, grant mic, talk

Full walkthrough: Install the CLI →

3

Two ideas worth knowing

That's all the vocabulary you need to read the rest of the docs.

Essence 2 vs Expression 2

Pick a model by character. Essence 2 is the default for photorealistic people — it runs everywhere, from cloud GPUs to fully on-device. Expression 2 animates stylized characters and creatures. Either way you provide one portrait image and bitHuman generates the rest. Compare the models →

The .imx file

Every avatar is one portable .imx file. The same file plays back identically across Python, Swift, Android, the browser, and the CLI. How avatars work →