Skip to content

Agent Human Avatar Plugin#5340

Open
jcancinar wants to merge 11 commits intolivekit:mainfrom
agenthuman:main
Open

Agent Human Avatar Plugin#5340
jcancinar wants to merge 11 commits intolivekit:mainfrom
agenthuman:main

Conversation

@jcancinar
Copy link
Copy Markdown

@jcancinar jcancinar commented Apr 4, 2026

This PR adds an integration plugin for Agent Human, enabling real-time AI avatars in LiveKit agent sessions.

Overview

Agent Human provides live, lipsynced avatars that convert agent voice output into expressive video. This plugin connects LiveKit agents to Agent Human and publishes the resulting avatar stream back into the room.

Integration Docs: https://docs.agenthuman.com/documentation/livekit/overview

Live demo on our website: https://agenthuman.com (demo running on LiveKit actually)

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Apr 4, 2026

CLA assistant check
All committers have signed the CLA.

devin-ai-integration[bot]

This comment was marked as resolved.

devin-ai-integration[bot]

This comment was marked as resolved.

devin-ai-integration[bot]

This comment was marked as resolved.

devin-ai-integration[bot]

This comment was marked as resolved.

devin-ai-integration[bot]

This comment was marked as resolved.

…tarSession

- Changed environment variable name in README from LEMONSLICE_IMAGE_URL to AGENTHUMAN_AVATAR for clarity.
- Enhanced logging messages in api.py and avatar.py to include the [agenthuman] prefix for better traceability.
- Added retry mechanism in the session creation process to handle transient API connection errors.
- Improved error logging to provide better insights during failures.
- Removed the check for the AGENTHUMAN_AVATAR environment variable in the AgentHumanAPI class.
- This change simplifies the avatar handling logic by allowing a default avatar to be used if none is provided.
- Improved session management in AgentHumanAPI by adding ownership tracking for the aiohttp.ClientSession.
- Enhanced error handling during session creation to provide clearer feedback on unexpected API response structures.
- Updated AvatarSession to use session_id instead of conversation_id for better clarity in session management.
- Updated exception handling in the AgentHumanAPI class to catch both APIStatusError and AgentHumanException, ensuring more robust error management during API interactions.
- Enhanced exception handling in the AgentHumanAPI class to separately manage APIStatusError and AgentHumanException.
- Added logging for non-retryable APIStatusError to provide better insights during failures.
- Adjusted retry logic to ensure proper handling of exceptions and maintain clarity in error reporting.
- Simplified the construction of the room payload in the AgentHumanAPI class by consolidating the room dictionary into a single line for improved readability.
devin-ai-integration[bot]

This comment was marked as resolved.

jcancinar and others added 2 commits April 5, 2026 16:23
…nthuman/api.py

Co-authored-by: devin-ai-integration[bot] <158243242+devin-ai-integration[bot]@users.noreply.github.com>
- Updated the retry loop in the AgentHumanAPI class to include an additional iteration, ensuring that the maximum retry count is correctly applied during session creation attempts.
- This change aims to improve the reliability of session establishment by allowing one more retry in case of transient errors.
devin-ai-integration[bot]

This comment was marked as resolved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants