Skip to content
bitHuman
Join DiscordSign up

Developers · iPhone & iPad

A talking avatar for your iPhone and iPad app

The bitHuman Swift package renders Essence 2 — a photoreal person — or Expression 2 — any character — on the iPhone or iPad itself. Your app passes in 16 kHz speech from any voice stack and draws the frames it gets back.

API and SDK use requires the Creator plan or higher.

  • iOS 16+ · Expression 2
Quick startOpen the sample app
AI character Gio rendered by the Swift package on an iPhone

Install

Swift Package Manager
.package(url: "https://gitlab.com/bithuman/sdk/homebrew-bithuman", from: "3.0.0")
Products
.product(name: "Expression2", package: "homebrew-bithuman")   // any character
.product(name: "Essence2Kit", package: "homebrew-bithuman")   // a photoreal person

What you need: Xcode 26+, API secret (from the docs)

The full iPhone & iPad guide

  1. Add a conversation

    The Swift package only renders: your app passes in 16 kHz mono speech and draws the frames it returns. Bring your own voice stack, or let bitHuman's managed agent run the conversation instead.

    • Your own speech recognition, language model and voice

      Any stack works: the SDK takes 16 kHz mono speech. OpenAI Realtime returns 24 kHz audio: resample it to 16 kHz before you pass it in. The converter is in the docs.

      Resample speech to 16 kHz

    • Build the companion screen

      The companion guide walks through the whole loop on the phone: the SDK, the API secret, resampling, replies, interruption and closing the avatar with the screen.

      Companion app (docs)

    • Or let bitHuman run the conversation

      The web embed runs a managed agent on bitHuman's servers with your persona and, if you like, your own OpenAI-compatible model; a LiveKit agent can use a bitHuman cloud avatar. Either way the avatar renders in the bitHuman cloud (the web embed's default), not on the phone.

      Web embed

    When the avatar renders in your app on the device and you use your own voice and language services, bitHuman receives usage metering only, never audio, video or conversation text.

Requirements

Essence 2 needs a physical iPhone or iPad; it does not run in the Simulator.

More

What it costs

Credits per minute

On the device (Essence 2, Expression 2)
2
bitHuman cloud avatar
4
Managed voice chat (all-inclusive)
10

More

Not available on this platform

A conversation brain that runs on the iPhone: the conversation is your app's, or runs in the cloud.

More

Before you ship

The full checklist

Examples you can clone

Questions? Ask on Discord

Join the bitHuman Discord