OpenAvatarChat快速入门：10分钟搭建你的第一个AI数字人

OpenAvatarChat快速入门：10分钟搭建你的第一个AI数字人

【免费下载链接】OpenAvatarChat 项目地址: https://gitcode.com/gh_mirrors/op/OpenAvatarChat

OpenAvatarChat是一款模块化的交互数字人对话实现工具，能够帮助你在单台PC上快速搭建属于自己的AI数字人系统。无论是用于娱乐、教育还是客服，它都能为你提供灵活且强大的功能支持。

🎉 为什么选择OpenAvatarChat？

OpenAvatarChat凭借其独特的优势，成为AI数字人开发的理想选择：

• 模块化设计：采用灵活的模块化架构，可以轻松替换各个组件，实现不同功能组合，满足多样化需求。
• 多模态支持：支持文本、音频、视频等多种模态，打造更加丰富的交互体验。
• 易于部署：提供多种部署方式，无论是本地运行还是Docker容器化部署，都能快速上手。
• 丰富的数字人模型：支持LiteAvatar、LAM、MuseTalk等多种数字人模型，满足不同场景的需求。

🚀 快速开始

🔧 系统需求

在开始之前，请确保你的系统满足以下要求：

• Python版本 >=3.11.7, <3.12
• 支持CUDA的GPU（推荐NVIDIA RTX系列）
• 至少10GB显存（使用int4量化模型）或20GB显存（使用未量化模型）

📥 安装步骤

1. 克隆仓库

首先，克隆OpenAvatarChat仓库到本地：

git clone https://gitcode.com/gh_mirrors/op/OpenAvatarChat
cd OpenAvatarChat

2. 初始化子模块

项目使用Git子模块管理依赖，需要初始化：

git submodule update --init --recursive --depth 1

3. 安装依赖

推荐使用uv进行依赖管理：

# 安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境
uv venv --python 3.11.11

# 安装依赖
uv run install.py --uv --config config/chat_with_openai_compatible_bailian_cosyvoice.yaml
./scripts/post_config_install.sh --config config/chat_with_openai_compatible_bailian_cosyvoice.yaml

▶️ 运行项目

一切准备就绪后，运行以下命令启动OpenAvatarChat：

uv run src/demo.py --config config/chat_with_openai_compatible_bailian_cosyvoice.yaml

启动成功后，打开浏览器访问 https://localhost:8282 即可开始使用你的AI数字人。

⚙️ 配置说明

OpenAvatarChat提供了多种预置配置，以适应不同的使用场景和硬件条件：

• chat_with_lam.yaml：使用LAM数字人模型，适合对设备性能要求较低的场景
• chat_with_qwen_omni.yaml：使用Qwen-Omni多模态模型，需要百炼API
• chat_with_openai_compatible.yaml：使用OpenAI兼容API，灵活性高
• chat_with_minicpm.yaml：本地运行MiniCPM模型，对GPU要求较高

你可以根据自己的需求和硬件条件选择合适的配置文件。

❓ 常见问题

如果在使用过程中遇到问题，可以参考常见问题文档，或加入我们的社区寻求帮助：

📚 学习资源

• 官方视频教程：在Bilibili上搜索"OpenAvatarChat"观看详细教程
• 项目文档：探索项目中的docs目录获取更多技术细节
• 示例代码：参考tests目录下的示例代码，快速理解如何扩展功能

🤝 社区贡献

OpenAvatarChat是一个开源项目，欢迎各位开发者贡献代码、报告问题或提出建议。你可以通过提交PR或Issue的方式参与到项目的发展中来。

希望本指南能帮助你快速搭建自己的AI数字人系统。如有任何疑问或建议，欢迎加入我们的社区交流讨论！

【免费下载链接】OpenAvatarChat 项目地址: https://gitcode.com/gh_mirrors/op/OpenAvatarChat