项目开源地址：https://gitee.com/dukeycn/dukeyai

最近很多做数字人、虚拟主播、短视频的朋友，都在找一款轻量、不挑配置、能本地离线跑的数字人驱动工具，LiteAvatar 无疑是目前性价比极高的一款。

但原版部署实在太麻烦：要装 Python、配依赖、搭环境、改路径，很多人折腾一天都跑不起来。

为了让大家省去所有繁琐步骤，我已经把 LiteAvatar 完整打包制作成 Windows 便携版，真正做到开箱即用。

基于 LiteAvatar 的数字人短视频生成系统，采用 Tauri + Vue 3 + Tailwind CSS 构建。

功能特性

• 🤖 AI数字人生成 - 基于 LiteAvatar 技术，输入文案即可生成口型同步的数字人视频
• 🎙️ 多音色语音合成 - 集成 Edge TTS，支持多种中文音色
• 🎤 音频录制 - 支持麦克风录制音频，自动转换为 MP3
• 📝 AI文案改写 - 智能改写文案，适配短视频风格
• 🖼️ 云端数字人 - 支持下载多种数字人形象
• 🔄 自动更新 - 启动自动检测新版本

系统要求

• Windows 10/11 (64位)
• 4GB+ 内存
• 3GB+ 磁盘空间
• 联网使用（必须）

便携包使用说明

1. 下载便携包

下载 DukeyAI-便携版.zip 并解压到纯英文路径（如 D:\DukeyAI\）。

⚠️ 重要：路径不能包含中文，否则会导致 AI 模型无法正常运行！

2. 首次启动

双击运行 第一次启动.bat，脚本会自动：

• 检查并安装 Python 3.10 便携版
• 安装 AI 依赖库（torch、onnxruntime 等）
• 下载 LiteAvatar 核心模型（约 1.3GB）
• 检查数字人模型

整个过程约需 5-10 分钟，取决于网络速度。

3. 日常使用

首次启动完成后，双击 启动DukeyAI.bat 即可运行软件。

4. 文件说明

文件	说明
DukeyAI.exe	主程序
第一次启动.bat	首次安装脚本
启动DukeyAI.bat	日常启动脚本
runtime/	Python 环境和依赖
_cachevideo/	临时缓存文件夹（退出自动清理）
my.json	用户配置文件

使用指南

生成数字人视频

1. 输入文案 - 在第一步输入分享文案或链接
2. 选择音频 - 三种方式：
   • TTS 语音合成（推荐）
   • 上传本地音频
   • 麦克风录制
3. 选择形象 - 下载并选择数字人形象
4. 生成视频 - 点击"启动数字人生成"

技术架构

核心技术

• 前端: Tauri 2.x + Vue 3 + TypeScript + Tailwind CSS
• 后端: Rust
• AI 引擎: LiteAvatar (Python 3.10)
• 语音合成: Edge TTS
• 音频处理: FFmpeg

模型文件

• model_1.onnx - 口型驱动模型
• lm.pb - 语言模型
• model.pb - 核心推理模型
• speech_paraformer - ASR 语音识别模型

开发环境

环境要求

• Node.js 18+
• Rust 1.77+
• Python 3.10

开发命令

# 安装依赖
npm install

# 开发模式
npm run tauri dev

# 构建
npm run tauri build

常见问题

Q: 为什么生成视频失败？

A: 请检查：

1. 是否完成首次启动配置
2. 网络连接是否正常
3. 磁盘空间是否充足

Q: 如何重新安装环境？

A: 删除 runtime 文件夹后重新运行 第一次启动.bat。