单词故事 项目简介

项目简介

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

项目荣誉

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

功能特色

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

在线使用

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

开发说明

该项目融合了以下技术：

  • 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
posted @ 2025-11-08 17:59  iMath  阅读(39)  评论(0)    收藏  举报
关于我和本博客(iMath.cnblogs.com)