awesome-digital-human本地部署及配置:打造高情绪价值互动指南

发布于:2025-05-10 ⋅ 阅读:(14) ⋅ 点赞:(0)

在数字化交互的浪潮中,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

三、部署项目

  1. 容器部署(推荐)
    容器部署环境隔离性好,操作简便,需提前安装Docker和Docker Compose。在项目根目录下执行:
    docker-compose up --build -d

  2. 裸机部署(适用于开发环境)
    后端部署:

安装后端依赖

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

  1. 注册与创建应用
    访问dify 官方网站完成注册登录,进入控制台创建新的聊天应用,获取应用的 API 密钥和访问地址。

  2. 项目配置
    方式一:在前端界面点击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”

  3. 借鉴 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目录下的文件,探索更多玩法。
以上内容涵盖部署、配置及优化技巧,若你在实践中有新需求,比如调整功能模块或解决特定问题,欢迎随时交流。


网站公告

今日签到

点亮在社区的每一天
去签到