Metadata-Version: 2.4
Name: alpha-avatar-plugins-persona
Version: 0.5.4
Summary: AlphaAvatar Framework plugin for persona service
Project-URL: Source, https://github.com/AlphaAvatar/AlphaAvatar
License-Expression: Apache-2.0
Keywords: AI,agents,langchain,llm,persona,profile
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: lancedb
Requires-Dist: langchain-community
Requires-Dist: langchain-core
Requires-Dist: langchain-openai
Requires-Dist: langchain-qdrant
Requires-Dist: qdrant-client
Requires-Dist: torchaudio>=0.10.1
Description-Content-Type: text/markdown

# Persona Plugin for AlphaAvatar

Support for **automatic extraction and real-time matching** of user **full-modality personas**, enabling Avatar to recognize, track, and personalize interactions based on multimodal signals.
This plugin provides a unified interface for **profiling** (semantic + vector representation), **speaker identification**, and **face recognition**, abstracting away backend complexity so developers can focus on building adaptive, personalized experiences.

## Features

* **Automatic Persona Extraction:**
  On-the-fly profiling of users based on conversation history, behavioral cues, and multimodal inputs. Persona profiles are represented as vector embeddings for efficient similarity search and personalization.

* **Real-time Persona Matching:**
  Incoming dialogue and multimodal signals are matched against stored persona profiles in real-time, ensuring the Avatar can recall context, traits, and preferences instantly.

## Installation

```bash
pip install alpha-avatar-plugins-persona
```

---

## Supported Modules

### Vector Store
| Module                 | Description                                                                                   | Docs                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **Qdrant** (default) | Combined framework for persona extraction pipelines and vector storage / retrieval.           | [Qdrant](https://qdrant.tech) |

### Profile
| Module                 | Description                                                                                   | Docs                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **LangChain** (default) | Combined framework for persona extraction pipelines and vector storage / retrieval.           | [LangChain](https://www.langchain.com) |

### Speaker
| Module     | Description                                                                               | Docs                                                                 |
| ---------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **ERes2NetV2** (default) | State-of-the-art deep speaker recognition model for speaker embedding and identification. | [3D-Speaker](https://github.com/modelscope/3D-Speaker)     |
| **wav2vec2-large-robust-6-ft-age-gender** (default) | Deep learning model for speaker embedding with additional age and gender recognition capabilities. | [audEERING](https://github.com/audeering/w2v2-age-gender-how-to)     |

### Face Recognizer
| Module  | Description                                                                                   | Docs                                                                 |
| ------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Face ID** (default) | Face embedding + recognition module for identity verification and multimodal persona binding. | (e.g., [InsightFace](https://github.com/deepinsight/insightface))    |
