Mega-ASR

环境要求

• Python 3.10（README 用 conda 创建 python=3.10 环境）
• 已安装 conda
• 已安装 git
• 可访问 GitHub 与 HuggingFace 以下载仓库与权重

安装与启动步骤

1. 1克隆并进入仓库

   从 GitHub 拉取 Mega-ASR 源码，并切换到项目根目录，后续命令都在此目录执行。

   git clone https://github.com/xzf-thu/Mega-ASR.git
   cd Mega-ASR

   复制

2. 2创建 conda 环境

   新建名为 mega-asr 的 Python 3.10 环境并激活，避免与其他项目依赖冲突。

   conda create -n mega-asr python=3.10 -y
   conda activate mega-asr

   复制

3. 3安装依赖

   在已激活的 mega-asr 环境中，按仓库提供的 requirements.txt 安装全部依赖。

   pip install -r requirements.txt

   复制

4. 4下载模型权重

   运行仓库自带下载脚本获取 Mega-ASR 权重（也可从 HuggingFace 页面手动下载）。

   python scripts/download.py

   复制

如何确认成功

README 未给出明确的启动校验方式；可确认下载脚本无报错结束，且权重文件已落到本地目录。

常见问题

注意事项

• 所有命令需在克隆后的 Mega-ASR 目录内执行。
• conda 环境名固定为 mega-asr，激活后再运行 pip 安装与脚本。
• README 节选缺少离线推理示例代码，实际使用前请先查阅仓库完整 README。
• 项目运行环境需能访问 GitHub 和 HuggingFace。