/VirtualWife

VirtualWife是一个虚拟数字人项目，项目还处于孵化阶段，有很多需要优化的地方，作者想打造一个拥有自己“灵魂”的虚拟数字人，你可以像朋友一样和她相识，作者希望虚拟数字人融入人类生活，作为恋爱导师，心理咨询师，解决人类的情感需求。

Primary LanguagePythonMIT LicenseMIT

VirtualWife

VirtualWife是一个虚拟数字人项目，项目还处于孵化阶段，有很多需要优化的地方，作者想打造一个拥有自己“灵魂”的虚拟数字人，你可以像朋友一样和她相识，作者希望虚拟数字人融入人类生活，作为恋爱导师，心理咨询师，解决人类的情感需求。

一期项目的功能，暂时还没有完整开发完，在项目中遇到问题可以在群里@Alan或者提issue，欢迎大佬贡献自己想法和代码

项目一期核心功能说明

项目一期核心技术栈说明

项目结构说明

核心服务说明

  • domain-chatbot: AI核心服务
  • domain-chatvrm: VRM聊天客户端
  • infrastructure-gateway: 基础设施-网关

FAQ

  • 项目答疑以及部署中遇到问题的解决方案，请查阅FAQ

快速开始

安装Docker环境

  • 方式一：命令行方式安装

  • 方式二：下载Docker桌面程序（桌面程序一般自带docker-compose）

    • 下载Docker桌面程序
    • 然后下一步下一步就安装好了，如果拉取镜像比较慢，可以更改为国内镜像地址

  • 检查是否安装成功，安装正常会打印日志

docker -v
docker-compose -v

进入VirtualWife安装程序目录

cd installer

├── README.md               # 安装程序使用说明
├── docker-compose.yaml     # docker编排文件
├── env_example             # 环境变量配置模版，使用时需要将文件名改成.env
├── milvus                  # 长期记忆，数据存储模块，启动程序
├── linux                   # linux 启动和关闭程序
│   ├── start.sh
│   └── stop.sh
└── windows                 # windows 启动和关闭程序
    ├── start.bat
    └── stop.bat

设置环境变量

  • 更改境变量配置模版文件名为.env
mv env_example .env
  • 设置环境变量
# B站直播间ID（计划放在页面设置，目前有问题，暂时使用环境变量解决）
B_STATION_ID=27892212
# 主播UID 获取方法：https://sdl.moe/post/bili-live-wss/
B_UID=38ccccc
# 打开b站页面后登录，然后F12随便找一个B站接口，从请求头中获取cookie
B_COOKIE="buvid3=Fggggg28116infoc"

# 时区
TIMEZONE=Asia/Shanghai

# 程序版本号，程序版本号可以查阅项目的release发布版本号，latest代表最新版本
CHATBOT_TAG=latest
CHATVRM_TAG=latest
GATEWAY_TAG=latest

启动程序

  • 以Linux系统为例，启动程序示例如下
## 进入linux脚本目录
cd linux

## 启动程序，初次启动需要下载镜像，整个过程可能需要5分钟
sh start.sh

访问页面

  • Web访问路径
http://localhost/
  • 页面展示

初始化数字人配置

基础配置

选择自己喜欢的角色和人物模型，并且选择大语言模型
如果是使用openai请将语言模型设置为openai

大语言模型配置

这以openai模型为例，你只需要将OPENAI_API_KEY填写好即可
如果有API代理可以将地址填写到OPENAI_BASE_URL

高级设置

如果没有OPENAI_BASE_URL，你需要配置http-proxy，
如果是使用docker启动的程序，需要使用docker的dns，
例如这样HTTP_PROXY=http://host.docker.internal:23457

保存

保存、保存、保存，重要的事情说三遍

保存成功后，无需重启服务，可以开始聊天了

本地开发

环境要求

  • python: 3.10.12
  • node: 14.21.3

如何启动domain-chatbot？

  • 进入domain-chatbot文件夹
cd domain-chatbot
  • 如何获取OpenAIKey?
  • 如何获取B站直播间ID？
    • 获取B站直播ID，前提是需要你自行注册B站直播用户
  • 创建.env文件，添加B站直播间ID（计划放在页面设置，目前有问题，暂时使用环境变量解决）
# B站直播间ID
B_STATION_ID=27xxx
# 主播UID 获取方法：https://sdl.moe/post/bili-live-wss/
B_UID=382xxxx
# 打开b站页面后登录，然后F12随便找一个B站接口，从请求头中获取cookie
B_COOKIE="buvid3=Fggggg28116infoc"
# 时区
TIMEZONE=Asia/Shanghai
  • 安装domain-chatbot项目依赖
pip3 install -r requirements.txt
  • 初始化项目数据库
python manage.py makemigrations 
python manage.py migrate
  • 启动domain-chatbot项目
python manage.py runserver

如何启动domain-chatvrm？

  • 进入domain-chatvrm文件夹
cd domain-chatvrm
  • 安装domain-chatvrm项目依赖
npm install
  • 启动domain-chatvrm项目
npm run dev
  • Web访问路径
http://localhost:3000/

技术交流群

winxin04.jpg