tango

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Python 环境（README 示例为 Python 脚本）
• 示例代码依赖 tango、soundfile、IPython 三个库
• 首次运行需联网下载模型权重，之后从本地缓存加载

安装与启动步骤

1. 1准备Python环境

   README 未给出安装命令，需自行安装 tango 包及其依赖（示例中用到 soundfile、IPython），并确保网络可访问模型仓库。

2. 2编写生成脚本

   新建脚本，加载 declare-lab/tango2 模型，用文本提示生成音频并以 16000 采样率写出 wav 文件。

   import IPython
   import soundfile as sf
   from tango import Tango
   
   tango = Tango("declare-lab/tango2")
   
   prompt = "An audience cheering and clapping"
   audio = tango.generate(prompt)
   sf.write(f"{prompt}.wav", audio, samplerate=16000)
   IPython.display.Audio(data=audio, rate=16000)

   复制

3. 3运行脚本

   执行脚本，首次运行会自动下载模型并保存到缓存，之后的运行直接读取缓存，不再重复下载。

   python tango_demo.py

   复制

4. 4提升生成音质

   generate 默认采样 100 步，官方建议改用 200 步以获得更好音质，代价是运行时间增加。

   prompt = "Rolling thunder with lightning strikes"
   audio = tango.generate(prompt, steps=200)
   IPython.display.Audio(data=audio, rate=16000)

   复制

5. 5批量生成音频

   用 generate_for_batch 传入提示列表，samples=2 表示每条提示各生成两个音频样本。

   prompts = [
       "A car engine revving",
       "A dog barks and rustles with some clicking",
       "Water flowing and trickling"
   ]
   audios = tango.generate_for_batch(prompts, samples=2)

   复制

关键配置

如何确认成功

脚本运行结束后目录下生成以提示词命名的 .wav 文件，并可通过 IPython.display.Audio 播放出对应音频。

常见问题

注意事项

• README 未提供 pip 安装命令，具体安装方式请以官方仓库说明为准。
• 首次运行需要联网下载模型权重，请保证网络畅通。
• steps 越大音质越好但耗时越长，按需在质量与速度之间取舍。
• 官方已推出更新的 TangoFlux 等模型，可关注仓库获取最新方案。