# AIFriends
**Repository Path**: elfbobo_admin_admin/aifriends
## Basic Information
- **Project Name**: AIFriends
- **Description**: AIFriend 是一个创新的虚拟朋友创作与分享平台,允许用户创建并分享虚拟角色(虚拟女友/男友/朋友)。每个角色都可以完全自定义,包括音色、性格和背景简介。平台集成了先进的语音技术,支持语音识别、语音合成与语音复刻,让用户能够与虚拟人物进行自然、流畅的语音通话交流。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# AIFriend - 虚拟朋友创作分享平台
一款专注于虚拟朋友创作、交互与社区分享的创新平台,让每个人都能打造专属虚拟伙伴。
---
## 📖 项目介绍
AIFriend 是一款集虚拟角色创作、语音交互、社区分享于一体的创新平台,核心定位是为用户提供"可自定义、可交互、可分享"的虚拟朋友体验。
用户可自由创建虚拟角色(虚拟女友/男友/朋友),对角色的音色、性格、背景简介进行全维度自定义,满足个性化需求。平台深度集成先进语音技术,涵盖语音识别、语音合成与语音复刻三大核心能力,打破文字交互的局限,让用户与虚拟人物实现自然、流畅的实时语音通话,打造沉浸式陪伴体验。
在线地址:https://app7694.acapp.acwing.com.cn/
---
## ✨ 主要功能
### 🎭 角色创作
- **全维度自定义**:自由配置音色、性格特质、背景故事、头像、背景图片
- **语音音色选择**:支持多种预设音色,可自定义语音参数
- **角色管理**:创建、编辑、删除、查看自己的虚拟角色
### 🎙️ 智能交互
- **自然语音对话**:高精度语音识别(ASR) + 流畅语音合成(TTS)
- **流式响应**:实时生成文本和语音,提供流畅的对话体验
- **长期记忆**:智能记忆用户偏好和对话历史,保持角色一致性
- **工具调用**:支持时间查询、知识库检索等智能工具
### 🧠 AI能力
- **大语言模型**:基于DeepSeek V3.2的智能对话
- **LangGraph智能代理**:结构化对话流程,支持工具调用
- **向量知识库**:基于LanceDB的语义检索
- **记忆管理**:自动总结对话,更新长期记忆
---
## 🏗️ 技术架构
- 后端 :Django
- 前端 :Vue 3 + Tailwind CSS + DaisyUI
- 大模型 :LangGraph + DeepSeek V3.2
- 数据库 :SQLite
- 语音技术 :语音识别(ASR) + 语音合成(TTS) + 语音复刻
---
## 📁 项目结构
```
aifriends/
├── backend/ # Django后端
│ ├── backend/ # Django项目配置
│ │ ├── settings.py # 核心配置文件
│ │ ├── urls.py # 主路由
│ │ └── wsgi.py
│ ├── web/ # 核心应用
│ │ ├── models/ # 数据模型
│ │ │ ├── user.py # 用户模型
│ │ │ ├── character.py # 角色模型
│ │ │ └── friend.py # 好友关系模型
│ │ ├── views/ # 视图函数
│ │ │ ├── user/ # 用户相关接口
│ │ │ ├── create/ # 角色创建接口
│ │ │ ├── friend/ # 好友/聊天接口
│ │ │ └── homepage/ # 首页接口
│ │ ├── documents/ # 知识库相关
│ │ ├── migrations/ # 数据库迁移
│ │ └── urls.py # API路由
│ └── manage.py
├── frontend/ # Vue前端
│ ├── src/
│ │ ├── components/ # 组件
│ │ │ ├── character/ # 角色相关组件
│ │ │ └── navbar/ # 导航栏组件
│ │ ├── views/ # 页面视图
│ │ ├── router/ # 路由配置
│ │ ├── stores/ # Pinia状态管理
│ │ └── js/ # 工具类
│ ├── index.html
│ ├── vite.config.js
│ └── package.json
├── requirements.txt # Python依赖
└── README.md
```
---
## 🔌 API接口
### 用户认证
- `POST /api/user/account/register/` - 用户注册
- `POST /api/user/account/login/` - 用户登录
- `POST /api/user/account/logout/` - 用户登出
- `POST /api/user/account/refresh_token/` - 刷新token
- `GET /api/user/account/get_user_info/` - 获取用户信息
- `POST /api/user/profile/update/` - 更新个人资料
### 角色管理
- `POST /api/create/character/create/` - 创建角色
- `POST /api/create/character/update/` - 更新角色
- `POST /api/create/character/remove/` - 删除角色
- `GET /api/create/character/get_single/` - 获取单个角色
- `GET /api/create/character/get_list/` - 获取角色列表
- `GET /api/create/character/voice/get_list/` - 获取声音列表
### 好友与聊天
- `POST /api/friend/get_or_create/` - 获取或创建好友关系
- `POST /api/friend/remove/` - 删除好友
- `GET /api/friend/get_list/` - 获取好友列表
- `POST /api/friend/message/chat/` - 发送消息(SSE流式响应)
- `GET /api/friend/message/get_history/` - 获取聊天历史
- `POST /api/friend/message/asr/asr/` - 语音识别
### 首页
- `GET /api/homepage/index/` - 首页数据
---
## 🎯 核心特性详解
### LangGraph智能代理
项目使用LangGraph构建智能对话代理,支持:
- 工具调用(时间查询、知识库检索)
- 流式响应
- Token统计
### 长期记忆管理
- 每1条对话自动更新记忆
- 使用独立的LangGraph进行记忆总结
- 记忆内容融入后续对话,保持角色一致性
### 语音交互
- **TTS**:使用cosyvoice-v3-flash模型
- **ASR**:语音识别转文字
- 支持音量、语速、音调自定义
### SSE流式响应
- 实时文本生成
- 实时音频流
- 提升用户体验