Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

three.ws Avatar SDK

three.ws

  • Free plan
  • Web
  • iPhone and iPad
  • Android
  • API
  • Self-hosted
7.5 Club score Visit three.ws

What three.ws Avatar SDK is

three.ws Avatar SDK gives app developers components and tools for adding 3D avatars to web projects. It includes web components, React bindings, an iframe-based creator, and cloud upload. The lightweight three-ws-viewer displays GLB or GLTF models with Three.js and OrbitControls, without AI or WebSocket features; a separate agent-3d component provides chat, voice, lipsync, animation, and skills. Typed, tree-shakeable React 18+ bindings include a useAvatar hook, while React is optional alongside Three.js. AvatarCreator opens Avatar Studio or Selfie Studio in an iframe and returns a GLB Blob. The saveBlob function uploads GLB files to R2 and registers the avatar; the SDK also supports USDZ generation for iOS and a half-body variant for VR. It bundles more than 50 Mixamo animations and supports compatible rigs. The SDK is described as self-hostable open source under Apache-2.0. The Free plan includes one agent, one custom avatar, unlimited embeds, a default rig, 200 animation clips, and community support. Pro costs $49/mo, billed monthly. Uploads with saveBlob require a bearer token with the avatars:write scope.

Who it suits

The SDK is intended for app developers adding 3D avatars through web components or React. It may suit teams that need an iframe-based creation flow, cloud upload, or a self-hosted option.

Good to know, and what to watch

  • Web components and React bindings
  • Viewer renders GLB and GLTF models
  • Creator returns an exported GLB Blob
  • Includes more than 50 Mixamo animations
  • Self-hostable under Apache-2.0
  • Viewer excludes AI and WebSocket features
  • saveBlob uploads require an avatars:write token
  • Pro costs $49/mo billed monthly

Enterprise

—

Free

Free

Pro

$49/mo

Free plan

Getting started

  1. Install @three-ws/avatar with Three.js
  2. Use web components or the optional React 18+ bindings
  3. Open Avatar Studio or Selfie Studio through AvatarCreator
  4. Export a GLB Blob from the creator flow
  5. Provide a bearer token with the avatars:write scope to saveBlob
  6. Choose public, unlisted or private avatar visibility

Limits to check

The Free plan includes one agent, one custom avatar, unlimited embeds, a default rig and 200 animation clips. Pro at $49 a month adds unlimited agents and custom avatars; Enterprise uses volume pricing with a tailored SLA.

The verdict

three.ws Avatar SDK offers distinct pieces for viewing, creating, and integrating avatars, with React optional. Developers should note that its viewer is separate from the AI runtime and that cloud uploads require a scoped token.

Questions people ask

Is three.ws Avatar SDK open source?

The SDK is described as self-hostable open source under the Apache-2.0 license.

What does the Free plan include?

It is free, billed forever, with one agent, one custom avatar, unlimited embeds, a default rig, 200 animation clips and community support.

How much is Pro?

Pro costs $49 a month, billed monthly. It lists unlimited agents and custom avatars, custom voice cloning, animation studio, memory seeds, priority CDN and GPU rendering, plus priority email support and an SLA.

Which avatar formats are supported?

The SDK lists GLB, glTF, USDZ and VRM exports, including rigged exports.

What is required to upload an avatar?

The saveBlob function uploads a GLB to R2 and requires a bearer token with the avatars:write scope. Visibility can be public, unlisted or private.

Does it work with React?

Yes. It includes typed, tree-shakeable React 18+ bindings and a useAvatar hook, while React is optional for installation.

What the maker publishes

AI runtime
The agent-3d component provides chat, voice, lipsync, animation, and skills. source
Animation
The SDK page says it bundles more than 50 Mixamo animations and supports Mixamo-compatible rigs. source
Audience
The SDK page presents the package for app developers adding 3D avatars through a web component or React. source
Avatar creation
AvatarCreator opens the Avatar Studio or Selfie Studio in an iframe and returns an exported GLB Blob. source
Dependencies
Installation uses @three-ws/avatar and Three.js; React is optional. source
Integrations
The SDK offers web components for HTML and frameworks, React bindings, and creator flows for Character Builder and Selfie Studio. source
License and hosting
The SDK page describes it as self-hostable open source under Apache-2.0. source
React
The package includes typed, tree-shakeable React 18+ bindings and a useAvatar hook. source
Support
The platform pricing page lists community support for Free and priority email support with an SLA for Pro. source
Upload access
saveBlob requires a bearer token with the avatars:write scope, and avatar visibility can be public, unlisted, or private. source
Upload and formats
saveBlob uploads a GLB to R2 and registers the avatar, with USDZ generation for iOS and a half-body variant for VR. source
Viewer
The lightweight three-ws-viewer renders GLB or GLTF models with Three.js and OrbitControls without AI or WebSocket features. source
What it does
The SDK provides web components, React bindings, an iframe avatar creator, and cloud upload for 3D avatars. source

Checked against the maker's pages on 4 Oct 2026.