Skip to content

v0.1.0

Release Date: 2026-07-12

Initial release of omniavatar-core, providing core interfaces for real-time AI avatars.

Highlights

  • Initial release of omniavatar-core interfaces
  • Provider-agnostic avatar abstraction for real-time AI avatars
  • Support for HeyGen, Tavus, and bitHuman avatar providers

Added

  • avatar.Provider interface for creating avatar sessions
  • avatar.Session interface for managing avatar lifecycle (Start, WaitForJoin, Close)
  • avatar.AudioDestination interface for streaming TTS audio to avatars
  • avatar.SessionConfig for provider-agnostic session configuration
  • avatar.SessionCallbacks for avatar events (OnAvatarJoined, OnPlaybackStarted, OnPlaybackFinished, OnError)
  • avatar.AudioConfig with DefaultAudioConfig() for 24kHz mono PCM16
  • avatar.Metrics for avatar performance metrics (join latency, playback latency)
  • registry.ProviderFactory type for provider registration
  • registry.ProviderConfig with Extensions map for provider-specific options
  • registry.WithAPIKey(), WithBaseURL(), WithExtension() option functions
  • Sentinel errors: ErrSessionNotStarted, ErrSessionAlreadyStarted, ErrAvatarJoinTimeout, ErrProviderNotFound
  • avatar.ProviderError for wrapping provider-specific errors

Documentation

  • README.md with architecture overview, interfaces, and usage examples
  • Package documentation in doc.go with code examples
  • Interface documentation with usage patterns

Full Changelog | Compare