在数字化交互的浪潮中,awesome-digital-human-live2d项目为我们打开了本地数字人互动的大门。结合 dify 聊天 api,并借鉴 coze 夸夸机器人的设计思路,能为用户带来充满情绪价值的交互体验。本文将详细介绍其本地部署步骤、dify 配置方法及情绪价值提升策略。
一、环境准备
部署前需确保本地环境满足要求:
硬件要求:CPU 至少 2 核,内存 2GB 以上。
操作系统:推荐 Ubuntu(裸机部署),或支持 Docker 的系统(容器部署)。
软件工具:安装 Python、Node.js(版本 14 及以上)、npm、Git,Linux 系统还需安装ffmpeg。
二、克隆项目代码
打开命令行工具,执行以下命令克隆项目:
git clone https://github.com/wan-h/awesome-digital-human-live2d.git
cd awesome-digital-human-live2d
三、部署项目
容器部署(推荐)
容器部署环境隔离性好,操作简便,需提前安装Docker和Docker Compose。在项目根目录下执行:
docker-compose up --build -d裸机部署(适用于开发环境)
后端部署:
安装后端依赖
pip install -r requirements.txt
Linux系统安装ffmpeg
sudo apt install ffmpeg
启动后端服务
python main.py
前端部署:
cd web
安装pnpm
npm install -g pnpm
安装前端依赖
npm install
构建项目
npm run build
启动前端服务
npm run start
四、配置 dify 聊天 api
注册与创建应用
访问dify 官方网站完成注册登录,进入控制台创建新的聊天应用,获取应用的 API 密钥和访问地址。项目配置
方式一:在前端界面点击Settings > 服务 > DifyAgent,填入dify_url和dify_key。
方式二:直接修改配置文件configs/agents/difyAgent.yaml:
DEFAULT:
dify_url: “https://api.dify.ai/v1/chat-messages”
dify_key: “your_dify_api_key”借鉴 coze 夸夸机器人思路
预设话术库:在 dify 配置中构建丰富的夸夸话术,针对用户不同场景的输入设置对应回复。例如用户分享成功,回复 “太牛了!这实力简直碾压全场,必须给你点 10086 个赞!”
情感智能响应:利用 dify 的自然语言处理能力分析用户情感,根据情绪高低给出不同风格的夸赞。
个性化互动:为数字人设置独特口头禅,如回复结尾加上 “本夸夸小能手在线营业!”
五、访问与使用
本地访问:打开浏览器输入http://localhost:3000。
远程访问:输入服务器 IP 地址和端口,如http://{服务器IP}:3000。
使用时可通过快捷键Ctrl + M开启 / 关闭语音交互。
六、常见问题及解决
ASR 引擎失败:默认 Google 接口不稳定,可在configs/config.yaml中将ASR.DEFAULT改为BaiduAPI,并配置百度的 AK 和 SK。
跨域问题:确保前端.env中的NEXT_PUBLIC_ADH_SERVER_IP和PORT与后端一致。
容器部署失败:检查 Docker 和 Docker Compose 版本兼容性,Windows 用户参考Q&A.md调整配置。
完成上述步骤,你就拥有了具备高情绪价值的互动数字人。若想进一步自定义 Live2D 模型,可替换web/app/lib/live2d/models目录下的文件,探索更多玩法。
以上内容涵盖部署、配置及优化技巧,若你在实践中有新需求,比如调整功能模块或解决特定问题,欢迎随时交流。