supertonic

环境要求

• Python 3.11（需在虚拟环境中使用）
• 可访问 GitHub 与 Hugging Face 的网络
• 按所选语言准备原生运行时：Go 需 ONNX Runtime C 库、Java 需 JDK 17、C# 需 .NET 9
• Node.js / Rust / Swift / Xcode 等对应语言工具链（仅运行相应用例时需要）

安装与启动步骤

1. 1克隆归档仓库

   原仓库已归档，必须从 supertone-oss-archive 组织克隆，README 给出的地址如下，克隆后进入项目目录。

   git clone https://github.com/supertone-oss-archive/supertonic.git
   cd supertonic

   复制

2. 2创建 Python 虚拟环境

   README 要求使用 Python 3.11，先创建虚拟环境 .venv，避免污染系统环境。

   python3.11 -m venv .venv

   复制

3. 3激活虚拟环境

   macOS/Linux 用 source 激活；Windows 在 PowerShell 中改用 .venv\Scripts\Activate.ps1。

   source .venv/bin/activate

   复制

4. 4安装模型下载工具

   README 指定使用 huggingface_hub 从归档命名空间下载模型文件。

   python -m pip install huggingface_hub

   复制

5. 5下载模型权重到 assets

   README 未给出具体下载命令，仅说明需显式从 Hugging Face 归档命名空间（supertone-oss-archive 下的 supertonic-3/2/1）下载模型，并放到仓库根目录的 assets/ 下。

6. 6运行语言示例

   README 提供了 Node.js、Browser、Java、C++、C#、Go、Swift、Rust、iOS 各自的运行命令，按需进入对应目录执行；语言示例读取本地的 assets/ 文件。

   cd nodejs
   npm install
   npm start

   复制

7. 7安装原生依赖（可选）

   Go 需先装 ONNX Runtime C 库（macOS：brew install onnxruntime）；Java 需 JDK 而非 JRE（macOS：brew install openjdk@17）。

   brew install onnxruntime
   brew install openjdk@17

   复制

如何确认成功

对应语言示例命令执行完毕且无报错，即表示本地推理链路（含 assets/ 模型文件）可用；README 未描述具体的启动成功日志。

常见问题

注意事项

• 该仓库已归档，仅作参考用途，不建议用于依赖长期维护的生产环境。
• 不提供托管 Demo 与 Voice Builder 服务，示例必须显式下载模型文件后本地运行。
• 本教程使用 Supertonic 3，README 的所有命令均以该版本为例。
• 代码与模型权重各自遵循不同的 LICENSE，使用前请分别确认。