# LanguageLearningAvatar

**Repository Path**: want595/language-learning-avatar

## Basic Information

- **Project Name**: LanguageLearningAvatar
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-24
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Language Learning Avatar

基于魔珐星云的多语言口语陪练助手，通过具身智能数字人提供沉浸式、有情感的实时外语对话练习体验。


![image](https://gitee.com/want595/markdown-images/raw/master/images/224/5/2025/12/24/2025122413171997525.webp)


## 项目简介

Language Learning Avatar 是一款创新的语言学习工具，旨在解决传统语言学习中缺乏真实口语交流环境的问题。通过魔珐星云的具身智能技术，构建了一位永远在线、耐心且富有表现力的 3D 数字人外教，为用户提供沉浸式的多语言对话练习体验。

### 核心特点

- **多语言支持**：支持英语、中文、日语、韩语、法语、德语、西班牙语等 7 种语言
- **具身智能交互**：数字人具备丰富的面部表情和肢体动作，提供情感反馈
- **实时语音对话**：低延迟的语音识别与合成，实现流畅的自然对话
- **智能纠错与翻译**：提供翻译辅助和角色扮演功能

## 技术架构

### 系统架构

### 技术栈

- **前端**：Vue 3 + Vite + TypeScript
- **后端**：Python (Flask)
- **大语言模型**：通义千问 Qwen3-235B-Instruct
- **ASR/TTS**：腾讯云 ASR 及魔珐星云 API
- **3D 数字人**：魔珐星云 SDK

### 系统架构图

![image](https://gitee.com/want595/markdown-images/raw/master/images/224/4/2025/12/24/2025122410535397436.webp)

## 功能特性

### 1. 多语言实时语音对话
- 支持 7 种语言自由切换
- 集成低延迟 ASR（自动语音识别）与 LLM（大语言模型）
- 实现流畅的自然语言问答，模拟真实的对话节奏

### 2. 具身智能情感交互
- 数字人具备丰富的情感表现力
- 根据对话内容自动匹配相应的面部表情和肢体动作
- 在用户回答正确时点头微笑，在思考时做出倾听姿态
- 增强人机连接，降低用户的开口焦虑

### 3. 智能纠错与翻译辅助
- **翻译模式**：当用户遇到表达困难时，可请求数字人进行翻译
- **角色扮演**：针对不同语言设定特定的 System Prompt，使数字人保持"耐心导师"的人设

## 目标用户

- K12 学生及大学生（需应对口语考试）
- 职场人士（商务英语/多语言沟通需求）
- 语言爱好者（希望低成本保持语感）

## 安装与使用

### 环境要求

- Node.js 16+
- Python 3.8+
- 魔珐星云 SDK 访问权限
- 通义千问 API 访问权限

### 环境配置

本项目需要配置以下 API 密钥才能正常运行。请按照以下步骤获取并配置：

- 访问 [腾讯云控制台](https://console.cloud.tencent.com/)
- 开通语音识别服务并获取 AppId、SecretID、SecretKey

将获取的密钥添加到 `app.py` 文件中的：
```
'asrAppId': 'xxx',
'asrSecretId': 'xxx',
'asrSecretKey': 'xxx',
```
### 前端设置

```bash
# 安装依赖
npm install

# 开发模式运行
npm run dev

# 构建生产版本
npm run build
```

### 后端设置

```bash
# 安装 Python 依赖
pip install -r requirements.txt

# 运行后端服务
python app.py
```

## 项目结构

```
LanguageLearningAvatar/
├── src/                    # 前端源代码
│   ├── components/         # Vue 组件
│   ├── views/             # 页面视图
│   ├── services/          # 服务模块
│   └── utils/             # 工具函数
├── backend/               # 后端代码
├── public/                # 静态资源
└── README.md
```

## 许可证

本项目为魔珐星云具身智能黑客松参赛作品。