项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 1018
使用教程
环境要求
- Python 3.12 或 3.13
- 已安装 uv 包管理器
- git(需要 git clone 拉取仓库)
- 可选:NVIDIA GPU(安装 cuda extra)
- 可选:Docker 与 docker-compose(容器方式运行)
安装与启动步骤
-
1克隆项目仓库
README 明确要求用 git clone 安装,因为训练和测试还需要 ctc_decoders、rnnt_loss 等第三方包。
git clone https://github.com/TensorSpeech/TensorFlowASR.git cd TensorFlowASR -
2安装默认依赖
普通 uv sync 会安装 tensorflow 与 tensorflow-text,CPU 和 Apple Silicon 用这一条即可。
uv sync -
3可选装GPU支持
NVIDIA 显卡用户改用带 cuda extra 的命令,会安装 tensorflow[and-cuda]。
uv sync --extra cuda -
4可选装开发工具
需要 pytest、ruff、pre-commit 等开发与导出工具时追加 dev extra。
uv sync --extra dev -
5验证命令行
README 示例用 uv run 在环境中执行命令,能打印帮助信息说明安装完成。
uv run tensorflow_asr --help -
6可选:安装TPU版
Cloud TPU 不是 extra,需先 sync 再跑脚本;脚本会先卸载原版 tensorflow 再装 TPU 版。
uv sync && ./scripts/install_tpu.sh -
7可选:容器启动
README 在 Installation 中给出容器运行方式,直接用 docker-compose 后台启动。
docker-compose up -d
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
extra: cuda | 否 | 在 pyproject.toml 中声明,安装 tensorflow[and-cuda] 供 NVIDIA GPU 使用 | uv sync --extra cuda |
extra: dev | 否 | 安装 pytest、ruff、pre-commit、绘图与导出工具 | uv sync --extra dev |
_(无 extra) | 是 | 默认只装 tensorflow 与 tensorflow-text,适合 CPU 与 Apple Silicon | uv sync |
如何确认成功
执行 uv run tensorflow_asr --help 能正常输出帮助信息;容器方式可确认 docker-compose up -d 后容器处于运行状态。
常见问题
Q:为什么必须用 git clone 而不是 pip 安装?
A:README 说明训练和测试需要从其他作者处安装 ctc_decoders、rnnt_loss 等必要包,因此官方推荐 clone 仓库后安装。
Q:没有 NVIDIA 显卡能装吗?
A:可以。普通 uv sync 安装的 tensorflow + tensorflow-text 在 CPU 和 Apple Silicon 上都能用,GPU 支持是可选的 cuda extra。
Q:Cloud TPU 直接加 extra 行不行?
A:不行。README 说明 tensorflow-tpu 自带一份 tensorflow 发行版,只能用 ./scripts/install_tpu.sh 安装,否则两个版本会互相覆盖。
Q:TPU 安装后重新 uv sync 会有问题吗?
A:会。后续任何 uv sync 都会把原版 tensorflow 装回来,需要重新执行 ./scripts/install_tpu.sh。
Q:可以用 Docker 跑吗?
A:可以,README 的 Installation 中给出 docker-compose up -d,即可在容器中启动。
注意事项
- Python 版本要求为 3.12 或 3.13,版本不符可能导致安装失败。
- 项目使用 uv 作为包管理器,所有命令建议通过 uv run 在项目环境中执行。
- README 本节只给出安装方式,训练、推理、TFLite 转换等具体用法需查阅对应 Tutorial 与 Inference 章节。
- TPU 脚本会卸载并覆盖原版 tensorflow,且每次 uv sync 后都要重跑。
核心亮点
- 模型覆盖全,Conformer、ContextNet、Jasper、DeepSpeech2、RNN-T 一库集成
- 支持字符与 subword 两种建模,方便中英文等多语言场景
- 配置驱动,YAML 切换模型与数据集,训练推理脚本完整
不足之处
- 相比 ESPnet、WeNet 等社区,文档与教程仍偏少,上手需读源码
- 预训练模型和中文数据配方有限,开箱即用程度一般
适用场景
- 在 TF2 技术栈中训练自定义语音识别模型
- 做 Conformer、RNN-T 等结构对比实验
- 为已有 TensorFlow 服务添加语音识别能力
替代项目
ESPnet、WeNet、K2/icefall
上一篇:mlx-qwen3-asr
下一篇:asryx
同类项目推荐
vocotype-cli
开源
按快捷键说话,文字自动输入到当前应用,本地运行不上传。
VocoType 是一款运行在本地端侧的隐私安全语音输入工具,通过快捷键即可将语音实时转换为文···
PyAutoSRT
开源
拖入视频,自动生成原文+翻译字幕
PySimpleGUI based DESKTOP APP to AUTO GENERATE SUBTITLE FILE (using free Google Spee···
whisper-stream
开源
终端里持续听写,说完自动出文字
A bash script using OpenAI Whisper API for continuous audio transcription with autom···
MOSS-Transcribe-Diarize
开源
0.9B 模型搞定 50+ 语言长音频转写、说话人分离和字幕生成
A 0.9B model for long-form transcription in 50+ languages with speaker diarization, ···
web-voice-processor
开源
浏览器麦克风音频一键转 16kHz PCM,直喂语音识别
A library for real-time voice processing in web browsers
moshi-rag
开源
边聊边查,语音对话不再瞎编
MoshiRAG is a compact full-duplex speech language model augmented with asynchronous ···
openwhispr
开源
本地优先的语音转文字,隐私不妥协,跨平台即装即用。
Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (B···
cobra
开源
本地实时判断有没有人说话,省算力又护隐私
On-device voice activity detection (VAD) powered by deep learning
deepgram-dotnet-sdk
开源
在 .NET 项目中快速接入 Deepgram 语音识别与合成,实现语音交互。
Official .NET SDK for Deepgram.
