# englishspeak

**Repository Path**: 575182772/eng

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-04
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpeakBuddy - 英语口语练习系统

基于豆包端到端实时语音大模型 O2.0 的本地口语练习 Web 服务。

## 目录结构

```
/home/dadami/EnglishSpeak/
├── backend/              # 后端服务 (Python FastAPI)
│   ├── main.py          # 主程序入口
│   ├── requirements.txt # Python 依赖
│   └── start.sh         # Linux 启动脚本
├── frontend/            # 前端资源
│   ├── static/          # CSS、JS 文件
│   │   ├── css/
│   │   └── js/
│   └── templates/       # HTML 模板
│       ├── index.html
│       ├── chat.html
│       ├── review.html
│       └── settings.html
└── docs/                # 文档
    └── README.md        # 项目说明
```

## 快速启动

### 1. 配置 API 密钥

编辑 `backend/server.py`，填入你的火山引擎密钥：
```python
APP_ID = "你的 AppID"
ACCESS_KEY = "你的 AccessKey"
```

### 2. 启动服务

```bash
cd /home/dadami/EnglishSpeak/backend
./start.sh
```

或手动启动：
```bash
cd /home/dadami/EnglishSpeak/backend
source .venv/bin/activate
python3 server.py
```

### 3. 访问

- 本机：https://localhost:18097
- 局域网：https://IP:18097

> ⚠️ 首次访问会提示证书不安全，点击继续访问即可

## 素材导入

通过 API 导入口语练习素材：

```bash
curl -X POST https://localhost:18097/api/materials \
  -H "Content-Type: application/json" \
  -d '{
    "primary": [...],
    "middle": [...],
    "high": [...]
  }'
```

详见 `docs/README.md`