dots.tts

环境要求

• Python 3.10–3.12（README 推荐使用全新的 conda 环境）
• 已安装 conda（用于创建隔离环境）
• 可用的 pip 包管理环境
• 可选：如需以 OpenAI 兼容接口提供服务，需按官方文档安装 sglang-omni
• 可访问 Hugging Face 以下载 dots-studio/dots.tts-mf 模型权重

安装与启动步骤

1. 1创建虚拟环境

   README 建议新建干净的 conda 环境，Python 版本选 3.10，避免与已有依赖冲突。

   conda create -n dots_tts python=3.10 -y

   复制

2. 2激活环境

   后续所有安装与运行命令都要在这个已激活的环境里执行。

   conda activate dots_tts

   复制

3. 3从 PyPI 安装

   最简安装方式，一条命令装好 dots.tts 及其依赖。

   pip install dots.tts

   复制

4. 4或从源码安装

   需要本地开发或可编辑安装时使用，需带上 README 指定的约束文件以保证依赖版本兼容。

   git clone https://github.com/studio-dots-ai/dots.tts
   cd dots.tts
   pip install -e . -c constraints/recommended.txt

   复制

5. 5安装完整依赖

   需要训练或代码检查等额外能力时，安装 full 附加依赖组。

   pip install 'dots.tts[full]'

   复制

6. 6下载模型权重

   拉取 dots-studio/dots.tts-mf 预训练权重，供后续推理或服务加载。

   hf download dots-studio/dots.tts-mf

   复制

7. 7启动兼容服务

   在 sglang-omni 仓库目录下执行，用官方示例配置启动监听 8000 端口的语音合成服务。

   sgl-omni serve --model-path dots-studio/dots.tts-mf --config examples/configs/dots_tts.yaml --port 8000

   复制

关键配置

如何确认成功

服务在 8000 端口正常监听、无报错退出，即可通过其 OpenAI 兼容的 /v1/audio/speech 接口请求合成语音并拿到音频。

常见问题

注意事项

• README 未给出统一的命令行推理入口，实际调用建议以仓库代码或 SGLang Omni 服务接口为准。
• 参考音频尽量选高采样率、低底噪、结尾无杂音的素材，克隆效果更好。
• 使用 SGLang Omni 前需按其官方安装文档装好环境，并在 sglang-omni 代码目录内执行启动命令。
• 本教程命令均来自 README，若上游接口有变动请以仓库最新说明为准。