MCPcopy Index your code
hub / github.com/Moeary/CosyVoiceDesktop

github.com/Moeary/CosyVoiceDesktop @V1.6

Chat with this repo
repository ↗ · DeepWiki ↗ · release V1.6 ↗ · + Follow
369 symbols 1,253 edges 24 files 102 documented · 28%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

# CosyVoice Desktop

面向多角色有声内容创作的桌面端 TTS 工具,基于 Cosyvoice3 TTS大模型 构建,提供文本编辑、角色配置、批量生成和本地 API 服务。

详细教程、页面说明、排错和完整更新记录已迁移到 Wiki: https://github.com/Moeary/CosyVoiceDesktop/wiki

核心能力

  • 多角色语音配置:角色名、参考文本、参考音频、模式、颜色统一管理。
  • 文本分段标注:支持右键 / Ctrl+数字 手动打标签。
  • AI 角色分配:调用 OpenAI 兼容 LLM 按段落自动识别角色,可手动确认或全自动应用。
  • 本地 TTS API:兼容 OpenAI TTS 风格接口,并提供酒馆以及 CosyVoice 原生接口。
  • 模型下载与配置记忆:路径、项目、角色配置自动持久化。

界面示例

  • 主界面预览
  • 语音配置面板
  • 生成日志与播放器

快速开始

1. 下载与启动

启动后按下面顺序使用:

  1. 双击 StartCosyvoice.bat 启动GUI应用,或使用 pixi start run 命令。
  2. 在“模型下载”页面准备 wetextCosyVoice3 模型。
  3. 打开语音设置页面,创建或导入角色配置,选择参考音频并点击"应用配置"(后续启动会自动加载)。
  4. 切换到文本编辑页面,输入或粘贴待合成文本,通过快捷键(Ctrl+数字)或右键工具菜单为不同段落分配语音配置(不同颜色标记)。
  5. 点击一键运行(或将任务转换为计划任务),切换到计划任务页面,查看任务执行日志和输出。
  6. 若合成效果不满意,可在计划任务页面点击"三角形运行按钮"进行重Roll。
  7. 所有段落合成完成后,点击"合成音频"按钮(需要ffmpeg环境),将分段音频合并为完整音频文件。

https://github.com/user-attachments/assets/569dbde3-e17f-4241-a723-d52f2b446341

文档入口

说明

  • 详细安装步骤、模型下载说明、页面教程、FAQ、更新日志和示例素材说明已迁移到 Wiki。
  • 请确保你对输入文本、参考音频和生成内容拥有合法使用权。

用户协议

  1. 本项目基于 CosyVoice 开源能力,遵循原项目许可证及使用规范。请在下载和部署前阅读并遵守 CosyVoice 官方条款。
  2. 用户在创作过程中应确保拥有使用输入文本、参考音频及生成内容的合法权利,不得侵犯第三方的版权、肖像权或其他合法权益。
  3. 禁止将本项目用于任何违法、违规或违背公共秩序与善良风俗的用途;如因违规使用导致损失,责任由用户自行承担。
  4. 项目提供的打包版本及脚本仅供个人学习与研究使用,未经许可不得用于商业再发行或转售。
  5. 项目维护者保留依据法律法规或社区反馈随时更新、暂停或终止服务与支持的权利。

使用 CosyVoiceDesktop 即视为同意上述协议条款。若您不同意任何条款,请立即停止使用并删除相关文件。

Core symbols most depended-on inside this repo

get
called by 163
core/config_manager.py
emit
called by 26
ui/api_page.py
_emit_log
called by 24
core/download.py
emit
called by 22
core/api.py
json_response
called by 22
core/api_routers/common.py
set
called by 20
core/config_manager.py
insert_tag
called by 17
ui/text_edit.py
add_log
called by 17
ui/task_plan.py

Shape

Method 254
Function 72
Class 32
Route 11

Languages

Python100%

Modules by API surface

ui/text_edit.py69 symbols
ui/api_page.py35 symbols
core/api.py33 symbols
ui/task_plan.py29 symbols
ui/main_window.py28 symbols
ui/model_download.py26 symbols
core/worker.py22 symbols
core/role_assigner.py22 symbols
ui/voice_settings.py21 symbols
core/api_routers/cosyvoice_native.py13 symbols
core/download.py11 symbols
ui/settings.py10 symbols

For agents

$ claude mcp add CosyVoiceDesktop \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact