Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

A real-time interactive Omni Avatar built on LiveKit, which allows you to seamlessly integrate with any open source Avatar components (real-time model, visual, voice, memory, search, etc.).

License

Notifications You must be signed in to change notification settings

AlphaAvatar/AlphaAvatar

Repository files navigation

The AvatarAlpha icon, the name of the repository.

PRs Welcome GitHub last commit License

GitHub watchers GitHub forks GitHub stars

Learnable, configurable, and pluggable Omni-Avatar Assistant for everyone

ROADMAP | Demo | HomePage | Documents


AlphaAvatar Plugins

🧠 Memory

Self-improving memory module for Omni-Avatar.

README↗

🧬 Persona

Automatic extraction and real-time matching of user full modality persona.

README↗

💡 Reflection

Planned

An Optimizer for Omni-Avatar that can automatically build an internal knowledge base for avatars.

README↗

🗺️ Planning

Planned

Agents need to plan over a longer time frame to ensure that their actions are sequential and reliable.

README↗

🤖 Behavior

Planned

Controls AlphaAvatar’s behavior logic and process flow.

README↗

😊 Virtual Character

The real-time generated virtual character that visually represents the Avatar during interactions.

README↗


Tools Plugins

🔍 DeepResearch

Allow AlphaAvatar to access the network and perform single-step/multi-step inference through a separate Agent service to search for more accurate content.

README↗

📖 RAG

Allow AlphaAvatar to access documents (user-uploaded/generated by the Reflection module/URL access) to obtain document-related information.

README↗


Docs and guides

Latest News 🔥

  • [2026/01] We have released AlphaAvatar version 0.3.0 to support DeepResearch by tavily API.
    • Released AlphaAvatar version 0.3.1: ADD tool calls during user-Assistant interactions to the Memory module.
  • [2025/12] We have released AlphaAvatar version 0.2.0 to support AIRI live2d-based virtual character display.
  • [2025/11] We have released AlphaAvatar version 0.1.0 to support automatic memory extraction, automatic user persona extraction and matching.

Installation ⚙️

Install stable AlphaAvatar version from PyPI:

uv venv .my-env --python 3.11
source .my-env/bin/activate
pip install alpha-avatar-agents

Install latest AlphaAvatar version from GitHub:

git clone --recurse-submodules https://github.com/AlphaAvatar/AlphaAvatar.git
cd AlphaAvatar

uv venv .venv --python 3.11
source .venv/bin/activate
uv sync --all-packages

Quick Start ⚡️

Start your agent in dev mode to connect it to LiveKit and make it available from anywhere on the internet:

export LIVEKIT_API_KEY=<your API Key>
export LIVEKIT_API_SECRET=<your API Secret>
export LIVEKIT_URL=<your LiveKit server URL>

export OPENAI_API_KEY=<your OpenAI API Key>

export QDRANT_URL='https://xxxxxx-xxxxx-xxxxx-xxxx-xxxxxxxxx.us-east.aws.cloud.qdrant.io:6333'
export QDRANT_API_KEY=<your QDRANT API Key>

# Optional
export TAVILY_API_KEY=<your TAVILY API Key>

alphaavatar download-files
alphaavatar dev examples/pipline_openai_airi.yaml
# or
alphaavatar dev examples/pipline_openai_tools.yaml

To see more supported modes, please refer to the LiveKit doc.

To see more examples, please refer to the Examples README

Usage 🚀

AlphaAvatar does not currently offer frontend support. Please start using it by visiting the LiveKit playground link:

playground airi screenshot

About

A real-time interactive Omni Avatar built on LiveKit, which allows you to seamlessly integrate with any open source Avatar components (real-time model, visual, voice, memory, search, etc.).

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published