LemonSlice Avatar Plugin for Vision Agents

Add real-time interactive avatar video to your AI agents using LemonSlice's self-managed API.

Features

Real-time avatar video synchronized with TTS audio
Works with any TTS provider (Cartesia, ElevenLabs, etc.)
Supports both standard and Realtime LLMs
Customizable avatar expressions via agent prompts

Installation

uv add "vision-agents[lemonslice]"
# or directly
uv add vision-agents-plugins-lemonslice

Quick Start

import asyncio
from uuid import uuid4
from dotenv import load_dotenv

from vision_agents.core import User, Agent
from vision_agents.plugins import cartesia, deepgram, getstream, gemini, lemonslice

load_dotenv()


async def start_avatar_agent():
    agent = Agent(
        edge=getstream.Edge(),
        agent_user=User(name="AI Assistant with Avatar", id="agent"),
        instructions="You're a friendly AI assistant.",

        llm=gemini.LLM(),
        tts=cartesia.TTS(),
        stt=deepgram.STT(),

        avatar=lemonslice.Avatar(agent_id="your-avatar-id"),
    )

    call = await agent.create_call("default", str(uuid4()))

    async with agent.join(call):
        await agent.simple_response("Hello! I'm your AI assistant with an avatar.")
        await agent.finish()


if __name__ == "__main__":
    asyncio.run(start_avatar_agent())

Configuration

Environment Variables

LEMONSLICE_API_KEY=your_lemonslice_api_key
LEMONSLICE_AGENT_ID=your_agent_id
# Or, instead of LEMONSLICE_AGENT_ID:
# LEMONSLICE_AGENT_IMAGE_URL=https://example.com/avatar.png

# LemonSlice uses LiveKit as a transport for audio and video
LIVEKIT_URL=wss://your-livekit-server.com
LIVEKIT_API_KEY=your_livekit_api_key
LIVEKIT_API_SECRET=your_livekit_api_secret

Avatar Options

lemonslice.Avatar(
    agent_id="your-avatar-id",  # LemonSlice agent ID (or set LEMONSLICE_AGENT_ID env var)
    agent_image_url=None,  # Custom image URL, 368x560px (or set LEMONSLICE_AGENT_IMAGE_URL env var)
    agent_prompt=None,  # Prompt to influence avatar expressions/movements
    api_key=None,  # Optional: override LEMONSLICE_API_KEY env var
    idle_timeout=None,  # Session timeout in seconds
    livekit_url=None,  # Optional: override LIVEKIT_URL env var
    livekit_api_key=None,  # Optional: override LIVEKIT_API_KEY env var
    livekit_api_secret=None,  # Optional: override LIVEKIT_API_SECRET env var
    width=1920,  # Output video width in pixels
    height=1080,  # Output video height in pixels
)

How It Works

LemonSlice Session: Creates a session via LemonSlice API, and joins the LiveKit room as a participant
Audio Forwarding: TTS audio is captured and sent to LemonSlice via the room
Avatar Generation: LemonSlice generates synchronized avatar video and audio
Video Streaming: Avatar video is streamed to call participants via GetStream Edge

Requirements

Python 3.10+
LemonSlice API key (get one at lemonslice.com)
LiveKit server (cloud or self-hosted)
GetStream account for video calls
TTS provider (Cartesia, ElevenLabs, etc.) or Realtime LLM

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vision_agents_plugins_lemonslice-0.6.7.tar.gz (8.1 kB view details)

Uploaded Jul 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

vision_agents_plugins_lemonslice-0.6.7-py3-none-any.whl (10.1 kB view details)

Uploaded Jul 14, 2026 Python 3

File details

Details for the file vision_agents_plugins_lemonslice-0.6.7.tar.gz.

File metadata

Download URL: vision_agents_plugins_lemonslice-0.6.7.tar.gz
Upload date: Jul 14, 2026
Size: 8.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for vision_agents_plugins_lemonslice-0.6.7.tar.gz
Algorithm	Hash digest
SHA256	`26f7495a26f73e4bce85e6e6abd84b0e85f360059deafa44b24f126b9ef9d501`
MD5	`84ecc15aac22538fb689c8f63e9d8cda`
BLAKE2b-256	`0afa66559d3a475a044f9704a94f9fecda4726e07b1336b4b0cee8e0042fdb5f`

See more details on using hashes here.

File details

Details for the file vision_agents_plugins_lemonslice-0.6.7-py3-none-any.whl.

File metadata

Download URL: vision_agents_plugins_lemonslice-0.6.7-py3-none-any.whl
Upload date: Jul 14, 2026
Size: 10.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for vision_agents_plugins_lemonslice-0.6.7-py3-none-any.whl
Algorithm	Hash digest
SHA256	`a5483f18f1bd00a4ad7b2ac2bfae84cf6e1a3050747ec1bbc60d94431b8ab3f5`
MD5	`3587051283a68a3cd51ac2ddd1779932`
BLAKE2b-256	`347a506e258cb3a658097c088fe66338698f40e9d73a826512a58645e81bbbea`