lhotse

环境要求

• Python 3.10 及以上（README 明确要求）
• pip（用于安装依赖和开发依赖）
• git（需克隆 GitHub 仓库）
• 可访问 GitHub 的网络环境

安装与启动步骤

1. 1确认 Python 版本

   Lhotse 只支持 Python 3.10 及以后版本，先确认本机版本满足要求，否则后面安装会失败。

   python --version

   复制

2. 2克隆仓库

   从 GitHub 拉取 lhotse 源码到本地当前目录，后续所有命令都要在 lhotse 目录内执行。

   git clone https://github.com/lhotse-speech/lhotse

   复制

3. 3安装开发依赖

   进入目录并做可编辑安装，[dev] 会额外装上跑测试、构建文档和启动 notebook 所需的依赖。

   cd lhotse
   pip install -e '.[dev]'

   复制

4. 4安装 pre-commit 钩子

   安装代码风格检查钩子，提交代码时会自动触发检查；不提交代码也可跳过。

   pre-commit install

   复制

5. 5运行单元测试

   执行项目自带的测试集，确认安装是否完整、代码能否正常工作。

   pytest test

   复制

6. 6运行代码检查

   执行 pre-commit 的 lint 检查，确认本地开发环境配置齐全。

   pre-commit run

   复制

如何确认成功

在 lhotse 目录下执行 pytest test，若测试正常收集并运行且无导入错误，说明安装成功。

常见问题

注意事项

• README 未给出端口、模型权重或云服务配置，本项目按 Python 库使用，不是独立服务。
• 建议在独立虚拟环境中执行安装，避免污染全局 Python 环境。
• Windows PowerShell 下安装命令中的单引号写法可能不适用，可改用双引号包裹 extras。