Skip to content

HeyGen improvements.#3653

Merged
filipi87 merged 3 commits intomainfrom
filipi/heygen_lite
Feb 10, 2026
Merged

HeyGen improvements.#3653
filipi87 merged 3 commits intomainfrom
filipi/heygen_lite

Conversation

@filipi87
Copy link
Copy Markdown
Contributor

@filipi87 filipi87 commented Feb 5, 2026 •
edited
Loading

Summary

  • Added support for sandbox mode in HeyGen LiveAvatar integration via is_sandbox parameter
  • Added configurable video settings (encoding type and quality level) via video_settings parameter
  • Changed default session mode from "CUSTOM" to "LITE" with VP8 as default encoding
  • Updated examples to use sandbox mode with the official sandbox avatar

@codecov
Copy link
Copy Markdown

codecov Bot commented Feb 5, 2026 •
edited
Loading

Codecov Report

❌ Patch coverage is 0% with 22 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/pipecat/services/heygen/api_liveavatar.py 0.00% 22 Missing ⚠️
Files with missing lines Coverage Δ
src/pipecat/services/heygen/api_liveavatar.py 0.00% <0.00%> (ø)

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

filipi87
filipi87 commented Feb 5, 2026
View reviewed changes
Comment thread src/pipecat/services/heygen/api_liveavatar.py

mode: str = "CUSTOM"
avatar_id: str
video_settings: Optional[VideoSettings] = VideoSettings(encoding=VideoEncoding.VP8)
Copy link
Copy Markdown
Contributor Author

@filipi87 filipi87 Feb 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suspect that HeyGen changed their API and started sending video using H.264 instead of VP8 by default.

While this works on other platforms, it looks like the LiveKit Python SDK on macOS is unable to decode H.264, so we don’t receive any video frames in Pipecat.

We will use VP8 as the default codec, while still allowing users to switch codecs in case H.264 works on other platforns.

filipi87 added a commit that referenced this pull request Feb 5, 2026
@filipi87 @claude
Add changelog entries for PR #3653.
ce7c8ba 
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@filipi87 filipi87 marked this pull request as ready for review February 5, 2026 19:33
markbackman
markbackman reviewed Feb 9, 2026
View reviewed changes
Comment thread src/pipecat/services/heygen/api_liveavatar.py

Parameters:
mode (str): Session mode (default: "CUSTOM").
mode (str): Session mode (default: "LITE").
Copy link
Copy Markdown
Contributor

@markbackman markbackman Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You've changed the docstring to a default of "LITE" but the actual mode default on line 83 is still "CUSTOM".

Copy link
Copy Markdown
Contributor Author

@filipi87 filipi87 Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

True, nice catch.

Copy link
Copy Markdown
Contributor Author

@filipi87 filipi87 Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed.

markbackman
markbackman reviewed Feb 9, 2026
View reviewed changes
Comment thread src/pipecat/services/heygen/api_liveavatar.py
markbackman
markbackman reviewed Feb 9, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@markbackman markbackman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just two small items then this is good to go.

@filipi87 filipi87 requested a review from markbackman February 10, 2026 16:59
markbackman
markbackman approved these changes Feb 10, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@markbackman markbackman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@filipi87 filipi87 merged commit 9c627e7 into main Feb 10, 2026
6 checks passed
@filipi87 filipi87 deleted the filipi/heygen_lite branch February 10, 2026 17:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@markbackman markbackman markbackman approved these changes

@kompfner kompfner Awaiting requested review from kompfner

@aconchillo aconchillo Awaiting requested review from aconchillo

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@filipi87 @markbackman