Lite-Avatar形象库Linux安装教程从入门到精通想快速拥有自己的数字人形象Lite-Avatar让你在Linux上轻松部署实时互动的2D数字人无需高端显卡CPU也能流畅运行1. 开始前的准备在动手安装之前先简单了解一下Lite-Avatar是什么。它是一个开源的2D数字人形象库能够通过音频实时驱动虚拟形象生成面部动画。简单说就是你说话数字人的嘴型和表情就会跟着动起来效果相当自然。最棒的是它不需要昂贵的显卡普通CPU就能跑到30帧每秒对硬件要求很友好。无论是做视频聊天、虚拟主播还是教育应用都很合适。你需要准备的东西一台Linux系统的电脑Ubuntu、CentOS等都行Python 3.8或更高版本至少4GB内存8GB更流畅稳定的网络连接需要下载一些模型文件不用担心自己是新手只要会复制粘贴命令就能跟着教程完成安装。2. 环境检查与基础配置打开你的终端我们先检查一下基础环境是否到位。检查Python版本python --version # 或者 python3 --version如果显示Python 3.8或更高版本那就没问题。如果版本太低需要先升级Python。安装Git如果还没有# Ubuntu/Debian系统 sudo apt update sudo apt install git # CentOS/RHEL系统 sudo yum install git安装必要的编译工具# Ubuntu/Debian sudo apt install build-essential libssl-dev zlib1g-dev # CentOS/RHEL sudo yum groupinstall Development Tools sudo yum install openssl-devel zlib-devel这些是基础开发工具确保后续安装过程不会出错。3. 获取Lite-Avatar项目代码现在我们来下载Lite-Avatar的源代码。推荐使用Git来克隆项目这样以后更新也方便。克隆项目仓库git clone https://github.com/HumanAIGC-Engineering/OpenAvatarChat.git cd OpenAvatarChat进入项目目录后还需要下载一些子模块更新子模块git submodule update --init --recursive --depth 1这个过程可能会花点时间取决于你的网速。如果遇到网络问题可以多试几次或者换个网络环境。4. 安装Python依赖包Lite-Avatar需要一些Python库的支持。推荐使用虚拟环境来管理依赖这样不会影响系统其他的Python项目。创建虚拟环境python -m venv liteavatar-env source liteavatar-env/bin/activate激活虚拟环境后你的命令行前面会出现(liteavatar-env)的提示表示现在在这个环境中操作。安装核心依赖pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu pip install modelscope1.25.0 openai1.74.0 pip install opencv-python-headless4.11.0.86 pip install gradio5.9.1 fastapi0.115.0这里安装的是CPU版本的PyTorch因为Lite-Avatar主要在CPU上运行。如果你有NVIDIA显卡并且想用GPU加速可以安装CUDA版本的PyTorch。安装音频处理相关依赖pip install funasr1.2.6 vocos0.1.0 pip install edge-tts7.0.0 pydub0.25.1这些库负责音频的处理和合成是数字人能够说话的关键。5. 下载模型文件Lite-Avatar需要一些预训练的模型文件才能工作。这些文件比较大需要耐心等待下载完成。下载SenseVoice语音识别模型python -m modelscope download --model iic/SenseVoiceSmall --local_dir ./models/iic/SenseVoiceSmall下载LiteAvatar数字人形象库python -m modelscope download --model HumanAIGC-Engineering/LiteAvatarGallery --local_dir ./resource/avatar/liteavatar这个形象库包含了100个预训练的数字人形象你可以根据需要选择使用哪个。下载口型动画模型wget https://virutalbuy-public.oss-cn-hangzhou.aliyuncs.com/share/aigc3d/data/LAM/LAM_audio2exp_streaming.tar -P ./models/LAM_audio2exp/ tar -xzvf ./models/LAM_audio2exp/LAM_audio2exp_streaming.tar -C ./models/LAM_audio2exp rm ./models/LAM_audio2exp/LAM_audio2exp_streaming.tar解压后检查一下文件是否完整应该能看到一个pretrained_models文件夹。6. 配置运行环境模型下载完成后我们需要进行一些配置才能正常运行。创建配置文件cp config/chat_with_openai_compatible_bailian_cosyvoice.yaml config/my_liteavatar.yaml编辑配置文件用你喜欢的文本编辑器打开config/my_liteavatar.yaml找到以下部分进行修改LiteAvatar: module: avatar/liteavatar/avatar_handler_liteavatar avatar_name: 20250408/sample_data # 默认形象可以改成其他形象 fps: 25 # 帧率可以根据性能调整 use_gpu: false # 如果没有GPU或者想用CPU保持false如果你有GPU并且想使用GPU加速可以把use_gpu改为true但通常CPU版本已经足够流畅。设置环境变量export PYTHONPATH$PYTHONPATH:$(pwd)/src这个设置让Python能够找到项目中的模块。7. 运行测试现在一切准备就绪让我们来测试一下安装是否成功。运行演示程序python src/demo.py --config config/my_liteavatar.yaml如果一切正常你会看到一些启动日志最后显示类似这样的信息Running on local URL: http://127.0.0.1:8282打开浏览器访问这个地址就能看到Lite-Avatar的界面了。测试音频驱动在界面中点击麦克风图标说几句话看看数字人的嘴型是否跟着动起来。第一次运行可能会需要一些时间初始化模型耐心等待一下。如果看到数字人随着你的声音做出相应的口型动作恭喜你安装成功了8. 常见问题解决安装过程中可能会遇到一些问题这里列出几个常见的解决方法问题1下载模型时网络超时# 可以设置代理或者重试几次 python -m modelscope download --model iic/SenseVoiceSmall --local_dir ./models/iic/SenseVoiceSmall --retry 5问题2内存不足如果运行时报内存不足可以尝试降低帧率LiteAvatar: fps: 15 # 从25降低到15问题3音频设备问题如果麦克风无法使用检查系统音频设置# 列出音频设备 arecord -l问题4Python包冲突如果遇到包版本冲突可以重新创建虚拟环境deactivate # 退出当前环境 rm -rf liteavatar-env # 删除旧环境 # 然后重新创建环境和安装依赖9. 下一步学习建议成功安装只是第一步这里有一些建议帮助你更好地使用Lite-Avatar探索不同形象形象库中有100个不同的数字人形象尝试换几个看看效果如何。只需要修改配置文件中的avatar_name参数即可。调整性能参数如果觉得运行不够流畅可以尝试调整帧率、音频采样率等参数找到性能和效果的平衡点。集成到自己的项目Lite-Avatar提供了API接口可以集成到你自己的应用程序中。查看项目文档了解如何调用。学习自定义形象进阶使用可以学习如何训练自己的数字人形象这样就能创造独一无二的虚拟形象了。记得定期查看项目更新开发团队经常会修复bug和添加新功能。如果遇到问题可以在项目的GitHub页面提交issue社区很活跃通常能得到及时的帮助。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。