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 An Optimizer for Omni-Avatar that can automatically build an internal knowledge base for avatars. README↗	🗺️ Planning Agents need to plan over a longer time frame to ensure that their actions are sequential and reliable. README↗
🤖 Behavior 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/API access) to obtain document-related information. README↗

---

Docs and guides

Latest News 🔥

• [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 source .my-env/bin/activate pip install alpha-avatar-agents

Install latest AlphaAvatar version from GitHub:

git clone https://github.com/AlphaAvatar/AlphaAvatar.git cd AlphaAvatar uv venv .venv 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> export TAVILY_API_KEY=<your TAVILY API Key> # Optional 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: