单词故事项目简介

项目简介 ¶

单词故事 ：听故事 = 复习 + 记忆单词！
单词故事利用 AI 将用户提供的一组单词或短语编成一个有趣的小故事，然后合成音频，使用户可以通过听故事来复习之前记过的单词——将枯燥的单词记忆变得轻松有趣起来！

项目荣誉 ¶

本项目参与了两个同期进行的比赛，均已入围。

成功获得 GitCode × 文心大模型 × 智源研究院 AI应用开发大赛 创新奖 。
成功入围「小有可为」AI 开源公益创新挑战赛。

功能特色 ¶

功能	说明
中英文故事生成	用单词或短语生成轻松有趣的英文小故事和对应的中文翻译，每个故事最多由 7 个单词或短语构成——基于 George A. Miller (1956) 的论文 The Magical Number Seven , Plus or Minus Two 所揭示的记忆规律。
语音合成	生成的音频故事包含各单词或短语的发音、释义、中英文故事，可在网站上或下载到手机或电脑反复使用。
一站式学习闭环	可与英酷词典（可负责记录陌生单词）和 Anki （负责单词视觉记忆）配套使用，单词故事也可导出为 Anki 记忆卡片，从“陌生单词记录 → 单词视觉记忆 → 单词复习”打造一站式学习闭环！
语义上下文学习	通过听觉与语境加深记忆，提高单词理解

在线使用 ¶

要体验请自己在本地部署（方法见后文）或访问：

https://mathjoy.eu.org/wordstory/category/%E8%80%83%E7%A0%94/
这是我部署在自己网站上的版本，上面包含一些已经生成的内容，如考研、四六级、雅思托福等等，方便直接使用。

开发说明 ¶

该项目融合了以下技术：

LLM 模型 ：文心大模型 4.5（旗舰版 API）——用于生成英文故事
TTS 引擎 ：Azure TTS —— 将生成的故事转换为音频
Gradio Web 界面 —— 让用户可直接在浏览器中交互、试听与下载故事

部署指南 ¶

1 克隆项目 ¶

# Make sure git-lfs is installed (https://git-lfs.com)
git lfs install

git clone https://huggingface.co/spaces/redstoneleo/WordsStory

# If you want to clone without large files - just their pointers
GIT_LFS_SKIP_SMUDGE=1 git clone https://huggingface.co/spaces/redstoneleo/WordsStory

cd WordsStory

2 创建虚拟环境 ¶

这里使用 uv ：

uv venv SiteEnv
source SiteEnv/bin/activate  # Windows: .\SiteEnv\Scripts\activate

3 安装依赖 ¶

uv pip install -r requirements.txt

若使用 pip ：
pip install -r requirements.txt

4 设置环境变量 ¶

这里以 Windows 上的 PowerShell 为例：

setx AZURE_TTS_KEY "your_AZURE_TTS_KEY"
setx OPENAI_API_KEY "your_BAIDU_CHATAI_KEY"

其中 Azure TTS 的 API Key 可以按照文档说明获取，需要绑定信用卡。
文心大模型 4.5 旗舰版 API Key 可以到这里获取。

5 启动 Gradio Web 界面 ¶

python app.py

然后打开浏览器访问
http://127.0.0.1:7860/

许可证 ¶

本项目采用GPL v3 License。

致谢 ¶

Kiro IDE
文心一言
Microsoft Azure Speech

单词故事 项目简介