Files
2026-07-13 13:39:38 +08:00

138 lines
5.0 KiB
Python

from __future__ import annotations
import os
import aiohttp
from livekit import api, rtc
from livekit.agents import (
DEFAULT_API_CONNECT_OPTIONS,
NOT_GIVEN,
AgentSession,
APIConnectOptions,
NotGivenOr,
get_job_context,
utils,
)
from livekit.agents.voice.avatar import AvatarSession as BaseAvatarSession, DataStreamAudioOutput
from livekit.agents.voice.room_io import ATTRIBUTE_PUBLISH_ON_BEHALF
from .api import DEFAULT_API_URL, AnamAPI
from .errors import AnamException
from .log import logger
from .types import PersonaConfig, SessionOptions
SAMPLE_RATE = 24000
_AVATAR_AGENT_IDENTITY = "anam-avatar-agent"
_AVATAR_AGENT_NAME = "anam-avatar-agent"
class AvatarSession(BaseAvatarSession):
"""A Anam avatar session"""
def __init__(
self,
*,
persona_config: PersonaConfig,
session_options: NotGivenOr[SessionOptions] = NOT_GIVEN,
api_url: NotGivenOr[str] = NOT_GIVEN,
api_key: NotGivenOr[str] = NOT_GIVEN,
avatar_participant_identity: NotGivenOr[str] = NOT_GIVEN,
avatar_participant_name: NotGivenOr[str] = NOT_GIVEN,
conn_options: APIConnectOptions = DEFAULT_API_CONNECT_OPTIONS,
) -> None:
super().__init__()
self._http_session: aiohttp.ClientSession | None = None
self._conn_options = conn_options
self.session_id: str | None = None
self._avatar_participant_identity = avatar_participant_identity or _AVATAR_AGENT_IDENTITY
self._avatar_participant_name = avatar_participant_name or _AVATAR_AGENT_NAME
self._persona_config: PersonaConfig = persona_config
self._session_options = session_options if utils.is_given(session_options) else None
api_url_val = (
api_url if utils.is_given(api_url) else os.getenv("ANAM_API_URL", DEFAULT_API_URL)
)
api_key_val = api_key if utils.is_given(api_key) else os.getenv("ANAM_API_KEY")
if not api_key_val:
raise AnamException("ANAM_API_KEY must be set by arguments or environment variables")
self._api_url = api_url_val
self._api_key = api_key_val
@property
def avatar_identity(self) -> str:
return self._avatar_participant_identity
@property
def provider(self) -> str:
return "anam"
def _ensure_http_session(self) -> aiohttp.ClientSession:
if self._http_session is None:
self._http_session = utils.http_context.http_session()
return self._http_session
async def start(
self,
agent_session: AgentSession,
room: rtc.Room,
*,
livekit_url: NotGivenOr[str] = NOT_GIVEN,
livekit_api_key: NotGivenOr[str] = NOT_GIVEN,
livekit_api_secret: NotGivenOr[str] = NOT_GIVEN,
) -> None:
await super().start(agent_session, room)
livekit_url = livekit_url or (os.getenv("LIVEKIT_URL") or NOT_GIVEN)
livekit_api_key = livekit_api_key or (os.getenv("LIVEKIT_API_KEY") or NOT_GIVEN)
livekit_api_secret = livekit_api_secret or (os.getenv("LIVEKIT_API_SECRET") or NOT_GIVEN)
if not livekit_url or not livekit_api_key or not livekit_api_secret:
raise AnamException(
"livekit_url, livekit_api_key, and livekit_api_secret must be set "
"by arguments or environment variables"
)
job_ctx = get_job_context()
local_participant_identity = job_ctx.local_participant_identity
livekit_token = (
api.AccessToken(
api_key=livekit_api_key,
api_secret=livekit_api_secret,
)
.with_kind("agent")
.with_identity(self._avatar_participant_identity)
.with_name(self._avatar_participant_name)
.with_grants(api.VideoGrants(room_join=True, room=room.name))
# allow the avatar agent to publish audio and video on behalf of your local agent
.with_attributes({ATTRIBUTE_PUBLISH_ON_BEHALF: local_participant_identity})
.to_jwt()
)
async with AnamAPI(
api_key=self._api_key, api_url=self._api_url, conn_options=self._conn_options
) as anam_api:
session_token = await anam_api.create_session_token(
persona_config=self._persona_config,
livekit_url=livekit_url,
livekit_token=livekit_token,
session_options=self._session_options,
)
logger.debug("Anam session token created successfully.")
logger.debug("Starting Anam engine session...")
session_details = await anam_api.start_engine_session(
session_token=session_token,
)
self.session_id = session_details.get("sessionId")
agent_session.output.replace_audio_tail(
DataStreamAudioOutput(
room=room,
destination_identity=self._avatar_participant_identity,
sample_rate=SAMPLE_RATE,
wait_remote_track=rtc.TrackKind.KIND_VIDEO,
),
)