Skip to content
View AlphaAvatar's full-sized avatar
🎯
Focus
🎯
Focus
  • Nanjing University
  • 中国-南京

Block or report AlphaAvatar

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
AlphaAvatar/README.md
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

Planned

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>

alphaavatar download-files
alphaavatar dev examples/pipline_openai_airi.yaml

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

Usage 🚀

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

playground airi screenshot

Pinned Loading

  1. AlphaAvatar AlphaAvatar Public

    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.).

    Python 555 23

  2. AIPaperNotes AIPaperNotes Public

    Record daily reading papers

    6