Skip to content

v0.2.0

Release Date: 2026-07-16

Adds a second product surface — asynchronous batch avatar video generation (render) — and renames the real-time package from avatar to live so the two surfaces are self-describing.

Highlights

  • New render package: provider-agnostic batch avatar video generation (submit narration audio, poll, download talking-head MP4)
  • Package avatar renamed to live (breaking; see below)
  • registry gains RenderProviderFactory; ProviderFactory renamed to LiveProviderFactory

Breaking Changes

  • Package avatar renamed to live. Update imports from github.com/plexusone/omniavatar-core/avatar to github.com/plexusone/omniavatar-core/live; all type and function names are unchanged (avatar.Provider → live.Provider, etc.)
  • Error string prefixes changed from avatar: to live:; ProviderError output prefix changed from avatar/ to live/
  • registry.ProviderFactory renamed to registry.LiveProviderFactory

Added

  • render.Provider interface: Generate, Status, Download for asynchronous video generation
  • render.AudioUploader optional capability interface for providers that can host local audio files
  • render.GenerateRequest with AvatarID, AudioURL (primary, drives lip-sync from existing narration), Script (secondary, provider TTS), dimensions, background, and provider-specific Extensions
  • render.Job, render.JobState (pending, processing, completed, failed with Terminal()), render.JobStatus with normalized state plus provider-native RawStatus
  • render.Wait polling helper with context cancellation and configurable interval
  • Sentinel errors: ErrAudioUploadUnsupported, ErrInvalidRequest, ErrJobNotFound, ErrJobFailed, ErrJobNotCompleted, ErrProviderUnavailable, ErrProviderAuthFailed, ErrInvalidConfig
  • render.ProviderError for wrapping provider-specific errors
  • registry.RenderProviderFactory type for render provider registration
  • Unit tests for the render package (Wait, state transitions, request validation)

Documentation

  • README.md and doc.go updated to document both live and render surfaces
  • MkDocs site added (interfaces reference for both surfaces, architecture, releases) with a Docs GitHub Actions workflow deploying via mkdocs gh-deploy

Full Changelog | Compare