---
title: Magic_Nebula_Digital_Human
canonical_url: "https://www.modelscope.cn/studios/Joe2yyo/Magic_Nebula_Digital_Human"
md_url: "https://www.modelscope.cn/studios/Joe2yyo/Magic_Nebula_Digital_Human.md"
repository: Joe2yyo/Magic_Nebula_Digital_Human
chinese_name: "魔珐星云数字人"
last_updated: 2026-04-30
sdk_type: docker
downloads: 0
stars: 1
---

# Magic_Nebula_Digital_Human

> Magic_Nebula_Digital_Human - Joe2yyo 在 ModelScope 创建的在线 Demo。交互学习git、docker等简单课程

Joe2yyo/Magic_Nebula_Digital_Human 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 docker 构建，中文名为「魔珐星云数字人」。

- **Repository**: Joe2yyo/Magic_Nebula_Digital_Human
- **SDK**: docker
- **Downloads**: 0
- **Stars**: 1
- **Last updated**: 2026-04-30

Source: https://www.modelscope.cn/studios/Joe2yyo/Magic_Nebula_Digital_Human

---

# AI 实时交互教育数字人

基于魔珐星云数字人SDK的实时交互教育平台，支持 Git / Docker 等技术课程的智能教学与实操练习。

## 功能特性

- **数字人交互**：基于魔珐星云SDK，支持流畅的语音对话与表情动画
- **智能教学**：集成大语言模型（通义千问），提供个性化教学反馈
- **实操终端**：内置真实终端环境，学生可直接执行命令并获得实时指导
- **语音识别**：支持语音输入，实现自然对话交互
- **课程引导**：提供 Git、Docker 等技术课程的结构化学习路径

## 环境运行要求

### 基础环境
- **Node.js** >= 18.x（用于前端构建）
- **Python** >= 3.10（用于后端服务）
- **npm** >= 9.x

### 必需的 API 密钥

| 服务 | 环境变量 | 获取方式 |
|------|----------|----------|
| 魔珐星云数字人 | `AVATAR_APP_ID`、`AVATAR_APP_SECRET` | [魔珐星云官网](https://xingyun3d.com) 注册获取 |
| ModelScope LLM | `MODEL_SCOPE_API_KEY` | [ModelScope](https://modelscope.cn) 个人中心获取 |
| 腾讯云语音识别（可选） | `ASR_SECRET_ID`、`ASR_SECRET_KEY` | [腾讯云控制台](https://console.cloud.tencent.com) |
| 终端网关（可选） | `TERMINAL_WS_UPSTREAM` | 自建 terminal-gateway 服务 |

## 快速开始

### 方式一：ModelScope 创空间部署（推荐）

1. **Fork 本项目**到你的 ModelScope 账号

2. **配置环境变量**：在创空间「设置」→「环境变量」中添加：
   ```
   AVATAR_APP_ID=你的数字人AppID
   AVATAR_APP_SECRET=你的数字人AppSecret
   MODEL_SCOPE_API_KEY=你的ModelScope API Key
   LLM_MODEL=Qwen/Qwen3-235B-A22B-Instruct-2507
   ```

3. **启动应用**：保存环境变量后，创空间会自动构建并部署

4. **访问体验**：部署完成后点击「打开应用」即可体验数字人交互

### 方式二：本地开发运行

1. **克隆项目**
   ```bash
   git clone https://www.modelscope.cn/studios/Joe2yyo/Magic_Nebula_Digital_Human.git
   cd Magic_Nebula_Digital_Human
   ```

2. **配置环境变量**
   ```bash
   cd 基础接入demo
   cp .env.example .env
   # 编辑 .env 文件，填入你的 API 密钥
   ```

3. **安装依赖并启动前端**
   ```bash
   npm install
   npm run dev
   ```

4. **启动后端服务**（新开终端窗口）
   ```bash
   cd ..
   pip install fastapi uvicorn httpx websockets
   python app.py
   ```

5. **访问应用**：打开浏览器访问 `http://localhost:7860`

### 方式三：Docker 部署

```bash
docker build -t magic-nebula-digital-human .
docker run -p 7860:7860 \
  -e AVATAR_APP_ID=你的AppID \
  -e AVATAR_APP_SECRET=你的AppSecret \
  -e MODEL_SCOPE_API_KEY=你的APIKey \
  magic-nebula-digital-human
```

## 项目结构

```
├── app.py                    # FastAPI 后端服务
├── Dockerfile                # Docker 构建配置
├── 基础接入demo/
│   ├── src/
│   │   ├── components/       # Vue 组件
│   │   ├── services/         # 服务层（数字人SDK、LLM等）
│   │   ├── stores/           # 状态管理
│   │   └── constants/        # 常量配置
│   ├── .env.example          # 环境变量示例
│   └── package.json
└── README.md
```

## 使用指南

1. **启动后等待数字人加载**：页面打开后会自动连接数字人SDK
2. **选择课程**：在右侧课程面板选择 Git 或 Docker 课程
3. **与数字人对话**：通过文字输入或语音按钮与数字人交流
4. **实操练习**：在下方终端中执行命令，数字人会实时给予指导反馈

## 常见问题

**Q: 数字人加载失败？**
- 检查 `AVATAR_APP_ID` 和 `AVATAR_APP_SECRET` 是否正确配置
- 确保网络能访问魔珐星云服务

**Q: 对话没有响应？**
- 检查 `MODEL_SCOPE_API_KEY` 是否有效
- 查看浏览器控制台是否有报错信息

**Q: 终端无法连接？**
- 本地开发时终端默认为模拟模式
- 真实终端需配置 `TERMINAL_WS_UPSTREAM` 指向 terminal-gateway 服务

## 技术栈

- **前端**：Vue 3 + TypeScript + Vite
- **后端**：FastAPI + Python
- **数字人**：魔珐星云 SDK
- **大模型**：通义千问（Qwen）
- **语音识别**：腾讯云 ASR

## License

Apache License 2.0