[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-libukai--Awesome-ChatTTS":3,"tool-libukai--Awesome-ChatTTS":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",141543,2,"2026-04-06T11:32:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":76,"owner_email":77,"owner_twitter":74,"owner_website":78,"owner_url":79,"languages":74,"stars":80,"forks":81,"last_commit_at":82,"license":74,"difficulty_score":10,"env_os":83,"env_gpu":84,"env_ram":85,"env_deps":86,"category_tags":95,"github_topics":97,"view_count":32,"oss_zip_url":74,"oss_zip_packed_at":74,"status":17,"created_at":100,"updated_at":101,"faqs":102,"releases":103},4506,"libukai\u002FAwesome-ChatTTS","Awesome-ChatTTS","官方推荐的 ChatTTS 资源汇总项目，整理了全网相关资源和常见问题 || Officially recommended ChatTTS resource collection project","Awesome-ChatTTS 是一个由社区维护、官方推荐的 ChatTTS 资源汇总项目，旨在帮助用户更轻松地探索和使用这款强大的开源文本转语音（TTS）工具。它并非单一的软件，而是一份精心整理的“导航图”，汇集了全网优质的演示地址、功能增强版分支、图形化界面工具以及常见问题解答。\n\n对于想要体验 ChatTTS 但苦于配置复杂的普通用户，这里提供了无需安装的网页版体验和一键运行的整合包；对于开发者和研究人员，项目收录了支持 API 调用、流式输出、批量处理及 ComfyUI 工作流集成的高级分支，极大地拓展了应用场景。此外，它还详细解析了如何通过调整文本种子、音色码及情感参数（如波动性、相关性）来精细控制合成效果，甚至支持结合 OpenVoice 进行声音克隆。\n\n无论是希望快速生成自然口语化音频的内容创作者、需要定制化语音方案的设计师，还是致力于二次开发的工程师，都能在这里找到合适的资源。Awesome-ChatTTS 有效解决了开源模型上手门槛高、功能分散的痛点，让高质量的声音合成变得触手可及。","![awesome.webp](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_7e1f983b0d0c.webp)\n\n\u003Cdiv align=\"center\">\n\n[**English**](.\u002FREADME-EN.md) | **简体中文**\n\n\u003C\u002Fdiv>\n\nAwesome-ChatTTS 是官方推荐的 ChatTTS 资源汇总项目，欢迎在 issues 中推荐或者自荐。 \n\n如果觉得本项目对你了解和使用 ChatTTS 有帮助，还请打赏个 ⭐️ 支持一下。\n\n> [!NOTE]\n> 以下项目均为社区资源，查看官方信息请到源仓库 [2noise\u002FChatTTS](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md) 。\n\n* [官方简介](#官方简介)\n* [快速体验](#快速体验)\n* [热门分支](#热门分支)\n* [界面说明](#界面说明)\n* [音色控制](#音色控制)\n* [入门教程](#入门教程)\n* [常见问题](#常见问题)\n* [报错速查](#报错速查)\n\n## 官方简介\n\nhttps:\u002F\u002Fgithub.com\u002Flibukai\u002FAwesome-ChatTTS\u002Fassets\u002F5654585\u002F532bfb80-316a-4244-9b92-301c732e8b63\n\n## 快速体验\n\n|                               网址                               | 类型          |\n|:--------------------------------------------------------------:|-------------|\n|           [ Original Web](https:\u002F\u002Fchattts.com\u002F#Demo)           | 原版网页版体验     |\n| [Forge Web](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002FlenML\u002FChatTTS-Forge) | Forge 增强版体验 |\n|           [Linux](https:\u002F\u002Fpypi.org\u002Fproject\u002FChatTTS\u002F)           | Python 安装包  |\n|              [Samples](http:\u002F\u002Fttslist.aiqbh.com\u002F)              | 音色种子示例      |\n|          [Cloning](http:\u002F\u002Fregion-9.autodl.pro:41137\u002F)          | 音色克隆体验      |\n\n## 热门分支\n\n### 功能增强\n\n|                                   项目                                    |                                 Star                                  | 亮点                   |\n|:-----------------------------------------------------------------------:|:---------------------------------------------------------------------:|----------------------|\n|  [jianchang512\u002FChatTTS-ui](https:\u002F\u002Fgithub.com\u002Fjianchang512\u002FChatTTS-ui)  | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fjianchang512\u002FChatTTS-ui)  | 提供 API 接口，可在第三方应用中调用 |\n|    [6drf21e\u002FChatTTS_colab](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_colab)    |  ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002F6drf21e\u002FChatTTS_colab)   | 提供流式输出，支持长音频生成和分角色阅读 |\n|      [lenML\u002FChatTTS-Forge](https:\u002F\u002Fgithub.com\u002FlenML\u002FChatTTS-Forge)      |   ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FlenML\u002FChatTTS-Forge)    | 提供人声增强和背景降噪，可使用附加提示词 |\n| [CCmahua\u002FChatTTS-Enhanced](https:\u002F\u002Fgithub.com\u002FCCmahua\u002FChatTTS-Enhanced) | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FCCmahua\u002FChatTTS-Enhanced) | 支持文件批量处理，以及导出 SRT 文件 |\n|  [HKoon\u002FChatTTS-OpenVoice](https:\u002F\u002Fgithub.com\u002FHKoon\u002FChatTTS-OpenVoice)  | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FHKoon\u002FChatTTS-OpenVoice)  | 配合 OpenVoice 进行声音克隆  |\n\n### 功能扩展\n\n|                                      项目                                      |                                                 Star                                                 | 亮点                            |\n|:----------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------:|-------------------------------|\n| [6drf21e\u002FChatTTS_Speaker](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_Speaker) |                 ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002F6drf21e\u002FChatTTS_Speaker)                 | 音色角色打标与稳定性评估                  |\n|         [AIFSH\u002FComfyUI-ChatTTS](https:\u002F\u002Fgithub.com\u002FAIFSH\u002FComfyUI-ChatTTS)          |                  ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FAIFSH\u002FComfyUI-ChatTTS)                  | ComfyUi 版本，可作为工作流节点引入         |\n| [MaterialShadow\u002FChatTTS-manager](https:\u002F\u002Fgithub.com\u002FMaterialShadow\u002FChatTTS-manager) |            ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMaterialShadow\u002FChatTTS-manager)             | 提供了音色管理系统和 WebUI 界面           |\n\n\n## 界面说明\n\n![配置项说明](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_e5ca069ccc9d.png)\n\n### 文本控制\n\n* **1. Input Text** : 需要转换的文本，支持中文和英文混杂\n* **2. Refine text** : 是否对文本进行口语化处理\n* **3. Text Seed** : 配置文本种子值，不同种子对应不同口语化风格\n* **4. 🎲** : 随机产生文本种子值\n* **5. Output Text** :  口语化处理后生成的文本\n\n### 音色控制\n\n* **6. Timbre** : 预设的音色种子值\n* **7. Audio Seed** : 配置音色种子值，不同种子对应不同音色\n* **8. 🎲** : 随机产生音色种子值\n* **9. Speaker Embedding** : 音色码，详见 [音色控制](#音色控制)\n\n### 情感控制\n\n* **10. temperate** : 控制音频情感波动性，范围为 0-1，数字越大，波动性越大\n* **11. top_P** ：控制音频的情感相关性，范围为 0.1-0.9，数字越大，相关性越高\n* **12. top_K** ：控制音频的情感相似性，范围为 1-20，数字越小，相似性越高\n\n### 系数控制\n\n* **13. DVAE Coefficient** : 模型系数码\n* **14. Reload** : 重新加载模型系数\n\n### 播放控制\n\n* **15. Auto Play** : 是否在生成音频后自动播放\n* **16. Stream Mode** : 是否启用流式输出\n* **17. Generate** : 点击生成音频文件\n* **18. Output Audio** : 音频生成结果\n* **19. ↓** : 点击下载音频文件\n* **20. ▶️** : 点击播放音频文件\n\n### 示例控制\n\n* **21. Example** : 点击切换示例配置\n\n## 音色控制\n\n经过实际测试，指定音色种子值每次生成 `spk_emb` 和重复使用预生成好的 `spk_emb` 效果有较显著差异，建议优先使用 `.pt` 音色文件或者音色码（字符串表示形式）。\n\n在 [ChatTTS_Speaker](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002Ftaa\u002FChatTTS_Speaker) 项目中对音色种子进行了初步打标和稳定性评估，可以通过示例来快速选择合适的音色。\n\n![audio-code.png](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_409b1524516c.png)\n\n### WebUI\n\n在官方 WebUI 中使用时，可直接将音色码复制之后，替换 `9. Speaker Embedding` 中的值，实现音色控制。\n\n### Python\n\n在 Python 脚本中使用时，参考 [issue#07](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_Speaker\u002Fissues\u002F7) 中的压缩方案实现音色控制。\n\n``` python\nspk = torch.load(\"asset\u002Fseed_1332_restored_emb.pt\", map_location=torch.device('cpu')).detach()\nspk_emb_str = compress_and_encode(spk)\n\nparams_infer_code = ChatTTS.Chat.InferCodeParams(\n    spk_emb= spk_emb_str,  # add sampled speaker\n    temperature=.0003,  # using custom temperature\n    top_P=0.7,  # top P decode\n    top_K=20,  # top K decode\n)\n```\n\n## 入门教程\n\n### 中文教程\n\n|                                                                    视频                                                                     | 亮点            |\n|:-----------------------------------------------------------------------------------------------------------------------------------------:|---------------|\n|                     [同济子豪兄](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Ui421v7JU\u002F?vd_source=b958002f14b88fc59432b810e4448b72)                      | 从入门到进阶的详细部署教程 |\n|                      [ZTFS](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1nZ421p74z\u002F?vd_source=6773fc664ee1e277b8a2290d66ebb7a3)                      | Mac M1 部署教程   |\n| [王-寳寳](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Ji421U74a\u002F?spm_id_from=333.337.search-card.all.click&vd_source=6773fc664ee1e277b8a2290d66ebb7a3) | Windows 部署教程  |\n\n### 英文教程\n\n|                                                                    视频                                                                     | 亮点            |\n|:-----------------------------------------------------------------------------------------------------------------------------------------:|---------------|\n|                     [Sam Witteveen](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=L4klnZ5Lox8)                      | 英文版介绍         |\n\n## 常见问题\n\n经过近期的迭代，源仓库代码中的问题已经基本解决。如果遇到问题，建议先详细查看 [官方说明文档中文版](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md) ，如果还有问题可以继续查看本文档。\n\n### 模型无法下载\n\n原版项目运行需要从 HuggingFace 下载对应的模型，如果不能顺畅科学上网，那么就无法完成这一步。作为替代方案，可以从 [modelscope](https:\u002F\u002Fwww.modelscope.cn\u002Fmodels\u002Fpengzhendong\u002FChatTTS\u002Ffiles) 上下载模型和配置，并配置本地路径。\n\n> [!Important]\n> 魔塔上的模型库是由志愿者维护的，不保证所有模型都是最新的，如果有需要请自行验证。\n\n1. 在终端中安装 modelscope 依赖\n\n``` bash\npip install modelscope\n```\n\n2. 修改 webui.py 中的代码\n\n``` python\n# 在开头导入依赖，并下载模型和配置\nfrom modelscope import snapshot_download\nmodel_dir = snapshot_download('zlj2546\u002FChatTTS')\n\n# 第 118 行修改模型路径\nret = chat.load_models('custom', custom_path=model_dir)\n```\n\n### IDE 中无法运行\n\n在 IDE 中运行时，由于文件相对路径的问题，导致脚本无法顺利运行。\n\n建议参照官方说明文档 [快速启动](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md#%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8) 中的指令直接在终端中运行。\n\n> 确保在执行以下命令时，处于项目根目录下。\n\n#### 1. WebUI 可视化界面\n\n```bash\npython examples\u002Fweb\u002Fwebui.py\n```\n\n#### 2. 命令行交互\n\n> 生成的音频将保存至 `.\u002Foutput_audio_n.mp3`\n\n```bash\npython examples\u002Fcmd\u002Frun.py \"Your text 1.\" \"Your text 2.\"\n```\n\n### 语气标签被读出\n\n出现这个问题是因为官方代码处理中文标点符号时覆盖不全，例如 `？`、`…` 等符号没有被处理，导致模型生成时出错。\n\n可以手动删除类似的中文标点符号，或者修改 `ChatTTS\u002Futils\u002Finfer_utils.py` 中的代码，在 103 行的 `character_map` 的字典中添加缺失的标点符号。\n\n```Python\ncharacter_map = {\n    '…': '',\n    '—': ',',\n    '＿': ',',\n    '？': ',',\n    }\n```\n\n### GPU 无法使用\n\nGPU 至少需要 4G 显存，否则将强制使用 CPU，相关问题可以参考 [ChatTTS-ui](https:\u002F\u002Fgithub.com\u002Fjianchang512\u002FChatTTS-ui) 项目中的说明\n\n## 报错速查\n\n1、`load_models() got an unexpected keyword argument 'source'`\n\n详见 **常见问题 - 模型无法下载**\n\n2、`cannot import name 'CommitOperationAdd' from 'huggingface_hub'`\n   \n详见 **常见问题 - 模型无法下载**\n\n3、 `FileNotFoundError：［Erzno 2］ No such file or directory： 'C：\\\\Users\\\\xxx\\\\.cache\\\\huggingface\\\\hub\\\\models--2Noise--ChatTTS\\\\snapshots\\`\n\n详见 **常见问题 - 模型无法下载**\n\n4、`local variable 'Normalizer' referenced before assignment`\n\n需要根据 **安装指南** 完成环境配置后，再安装 `pynini` 和 `WeTextProcessing` 依赖\n\n``` bash\nconda install -c conda-forge pynini=2.1.5 && pip install WeTextProcessing\n```\n\n5、`download to Local path D：\\pythonlproject\\ChatTTS\\ChatTTS failed.`\n\n在 IDE 中直接执行脚本，会因为文件路径问题报错，详见 **常见问题 - IDE 中无法运行**\n\n6、`ModuleNotFoundError : No module named'Cython'`\n\n未找到 Python 执行路径，Windows 设备需要按 [教程](https:\u002F\u002Fwww.cnblogs.com\u002Fajianbeyourself\u002Fp\u002F17654155.html) 配置环境路径\n\n\n## 项目趋势\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_6001d18c8962.png)](https:\u002F\u002Fstar-history.com\u002F#libukai\u002FAwesome-ChatTTS&Date)\n","![awesome.webp](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_7e1f983b0d0c.webp)\n\n\u003Cdiv align=\"center\">\n\n[**English**](.\u002FREADME-EN.md) | **简体中文**\n\n\u003C\u002Fdiv>\n\nAwesome-ChatTTS 是官方推荐的 ChatTTS 资源汇总项目，欢迎在 issues 中推荐或者自荐。 \n\n如果觉得本项目对你了解和使用 ChatTTS 有帮助，还请打赏个 ⭐️ 支持一下。\n\n> [!NOTE]\n> 以下项目均为社区资源，查看官方信息请到源仓库 [2noise\u002FChatTTS](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md) 。\n\n* [官方简介](#官方简介)\n* [快速体验](#快速体验)\n* [热门分支](#热门分支)\n* [界面说明](#界面说明)\n* [音色控制](#音色控制)\n* [入门教程](#入门教程)\n* [常见问题](#常见问题)\n* [报错速查](#报错速查)\n\n## 官方简介\n\nhttps:\u002F\u002Fgithub.com\u002Flibukai\u002FAwesome-ChatTTS\u002Fassets\u002F5654585\u002F532bfb80-316a-4244-9b92-301c732e8b63\n\n## 快速体验\n\n|                               网址                               | 类型          |\n|:--------------------------------------------------------------:|-------------|\n|           [ Original Web](https:\u002F\u002Fchattts.com\u002F#Demo)           | 原版网页版体验     |\n| [Forge Web](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002FlenML\u002FChatTTS-Forge) | Forge 增强版体验 |\n|           [Linux](https:\u002F\u002Fpypi.org\u002Fproject\u002FChatTTS\u002F)           | Python 安装包  |\n|              [Samples](http:\u002F\u002Fttslist.aiqbh.com\u002F)              | 音色种子示例      |\n|          [Cloning](http:\u002F\u002Fregion-9.autodl.pro:41137\u002F)          | 音色克隆体验      |\n\n## 热门分支\n\n### 功能增强\n\n|                                   项目                                    |                                 Star                                  | 亮点                   |\n|:-----------------------------------------------------------------------:|:---------------------------------------------------------------------:|----------------------|\n|  [jianchang512\u002FChatTTS-ui](https:\u002F\u002Fgithub.com\u002Fjianchang512\u002FChatTTS-ui)  | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fjianchang512\u002FChatTTS-ui)  | 提供 API 接口，可在第三方应用中调用 |\n|    [6drf21e\u002FChatTTS_colab](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_colab)    |  ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002F6drf21e\u002FChatTTS_colab)   | 提供流式输出，支持长音频生成和分角色阅读 |\n|      [lenML\u002FChatTTS-Forge](https:\u002F\u002Fgithub.com\u002FlenML\u002FChatTTS-Forge)      |   ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FlenML\u002FChatTTS-Forge)    | 提供人声增强和背景降噪，可使用附加提示词 |\n| [CCmahua\u002FChatTTS-Enhanced](https:\u002F\u002Fgithub.com\u002FCCmahua\u002FChatTTS-Enhanced) | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FCCmahua\u002FChatTTS-Enhanced) | 支持文件批量处理，以及导出 SRT 文件 |\n|  [HKoon\u002FChatTTS-OpenVoice](https:\u002F\u002Fgithub.com\u002FHKoon\u002FChatTTS-OpenVoice)  | ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FHKoon\u002FChatTTS-OpenVoice)  | 配合 OpenVoice 进行声音克隆  |\n\n### 功能扩展\n\n|                                      项目                                      |                                                 Star                                                 | 亮点                            |\n|:----------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------:|-------------------------------|\n| [6drf21e\u002FChatTTS_Speaker](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_Speaker) |                 ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002F6drf21e\u002FChatTTS_Speaker)                 | 音色角色打标与稳定性评估                  |\n|         [AIFSH\u002FComfyUI-ChatTTS](https:\u002F\u002Fgithub.com\u002FAIFSH\u002FComfyUI-ChatTTS)          |                  ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FAIFSH\u002FComfyUI-ChatTTS)                  | ComfyUi 版本，可作为工作流节点引入         |\n| [MaterialShadow\u002FChatTTS-manager](https:\u002F\u002Fgithub.com\u002FMaterialShadow\u002FChatTTS-manager) |            ![Star](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMaterialShadow\u002FChatTTS-manager)             | 提供了音色管理系统和 WebUI 界面           |\n\n\n## 界面说明\n\n![配置项说明](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_e5ca069ccc9d.png)\n\n### 文本控制\n\n* **1. Input Text** : 需要转换的文本，支持中文和英文混杂\n* **2. Refine text** : 是否对文本进行口语化处理\n* **3. Text Seed** : 配置文本种子值，不同种子对应不同口语化风格\n* **4. 🎲** : 随机产生文本种子值\n* **5. Output Text** :  口语化处理后生成的文本\n\n### 音色控制\n\n* **6. Timbre** : 预设的音色种子值\n* **7. Audio Seed** : 配置音色种子值，不同种子对应不同音色\n* **8. 🎲** : 随机产生音色种子值\n* **9. Speaker Embedding** : 音色码，详见 [音色控制](#音色控制)\n\n### 情感控制\n\n* **10. temperate** : 控制音频情感波动性，范围为 0-1，数字越大，波动性越大\n* **11. top_P** ：控制音频的情感相关性，范围为 0.1-0.9，数字越大，相关性越高\n* **12. top_K** ：控制音频的情感相似性，范围为 1-20，数字越小，相似性越高\n\n### 系数控制\n\n* **13. DVAE Coefficient** : 模型系数码\n* **14. Reload** : 重新加载模型系数\n\n### 播放控制\n\n* **15. Auto Play** : 是否在生成音频后自动播放\n* **16. Stream Mode** : 是否启用流式输出\n* **17. Generate** : 点击生成音频文件\n* **18. Output Audio** : 音频生成结果\n* **19. ↓** : 点击下载音频文件\n* **20. ▶️** : 点击播放音频文件\n\n### 示例控制\n\n* **21. Example** : 点击切换示例配置\n\n## 音色控制\n\n经过实际测试，指定音色种子值每次生成 `spk_emb` 和重复使用预生成好的 `spk_emb` 效果有较显著差异，建议优先使用 `.pt` 音色文件或者音色码（字符串表示形式）。\n\n在 [ChatTTS_Speaker](https:\u002F\u002Fhuggingface.co\u002Fspaces\u002Ftaa\u002FChatTTS_Speaker) 项目中对音色种子进行了初步打标和稳定性评估，可以通过示例来快速选择合适的音色。\n\n![audio-code.png](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_409b1524516c.png)\n\n### WebUI\n\n在官方 WebUI 中使用时，可直接将音色码复制之后，替换 `9. Speaker Embedding` 中的值，实现音色控制。\n\n### Python\n\n在 Python 脚本中使用时，参考 [issue#07](https:\u002F\u002Fgithub.com\u002F6drf21e\u002FChatTTS_Speaker\u002Fissues\u002F7) 中的压缩方案实现音色控制。\n\n``` python\nspk = torch.load(\"asset\u002Fseed_1332_restored_emb.pt\", map_location=torch.device('cpu')).detach()\nspk_emb_str = compress_and_encode(spk)\n\nparams_infer_code = ChatTTS.Chat.InferCodeParams(\n    spk_emb= spk_emb_str,  # add sampled speaker\n    temperature=.0003,  # using custom temperature\n    top_P=0.7,  # top P decode\n    top_K=20,  # top K decode\n)\n```\n\n## 入门教程\n\n### 中文教程\n\n|                                                                    视频                                                                     | 亮点            |\n|:-----------------------------------------------------------------------------------------------------------------------------------------:|---------------|\n|                     [同济子豪兄](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Ui421v7JU\u002F?vd_source=b958002f14b88fc59432b810e4448b72)                      | 从入门到进阶的详细部署教程 |\n|                      [ZTFS](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1nZ421p74z\u002F?vd_source=6773fc664ee1e277b8a2290d66ebb7a3)                      | Mac M1 部署教程   |\n| [王-寳寳](https:\u002F\u002Fwww.bilibili.com\u002Fvideo\u002FBV1Ji421U74a\u002F?spm_id_from=333.337.search-card.all.click&vd_source=6773fc664ee1e277b8a2290d66ebb7a3) | Windows 部署教程  |\n\n### 英文教程\n\n|                                                                    视频                                                                     | 亮点            |\n|:-----------------------------------------------------------------------------------------------------------------------------------------:|---------------|\n|                     [Sam Witteveen](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=L4klnZ5Lox8)                      | 英文版介绍         |\n\n## 常见问题\n\n经过近期的迭代，源仓库代码中的问题已经基本解决。如果遇到问题，建议先详细查看 [官方说明文档中文版](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md) ，如果还有问题可以继续查看本文档。\n\n### 模型无法下载\n\n原版项目运行需要从 HuggingFace 下载对应的模型，如果不能顺畅科学上网，那么就无法完成这一步。作为替代方案，可以从 [modelscope](https:\u002F\u002Fwww.modelscope.cn\u002Fmodels\u002Fpengzhendong\u002FChatTTS\u002Ffiles) 上下载模型和配置，并配置本地路径。\n\n> [!Important]\n> 魔塔上的模型库是由志愿者维护的，不保证所有模型都是最新的，如果有需要请自行验证。\n\n1. 在终端中安装 modelscope 依赖\n\n``` bash\npip install modelscope\n```\n\n2. 修改 webui.py 中的代码\n\n``` python\n# 在开头导入依赖，并下载模型和配置\nfrom modelscope import snapshot_download\nmodel_dir = snapshot_download('zlj2546\u002FChatTTS')\n\n# 第 118 行修改模型路径\nret = chat.load_models('custom', custom_path=model_dir)\n```\n\n### IDE 中无法运行\n\n在 IDE 中运行时，由于文件相对路径的问题，导致脚本无法顺利运行。\n\n建议参照官方说明文档 [快速启动](https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS\u002Fblob\u002Fmain\u002Fdocs\u002Fcn\u002FREADME.md#%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8) 中的指令直接在终端中运行。\n\n> 确保在执行以下命令时，处于项目根目录下。\n\n#### 1. WebUI 可视化界面\n\n```bash\npython examples\u002Fweb\u002Fwebui.py\n```\n\n#### 2. 命令行交互\n\n> 生成的音频将保存至 `.\u002Foutput_audio_n.mp3`\n\n```bash\npython examples\u002Fcmd\u002Frun.py \"Your text 1.\" \"Your text 2.\"\n```\n\n### 语气标签被读出\n\n出现这个问题是因为官方代码处理中文标点符号时覆盖不全，例如 `？`、`…` 等符号没有被处理，导致模型生成时出错。\n\n可以手动删除类似的中文标点符号，或者修改 `ChatTTS\u002Futils\u002Finfer_utils.py` 中的代码，在 103 行的 `character_map` 的字典中添加缺失的标点符号。\n\n```Python\ncharacter_map = {\n    '…': '',\n    '—': ',',\n    '＿': ',',\n    '？': ',',\n    }\n```\n\n### GPU 无法使用\n\nGPU 至少需要 4G 显存，否则将强制使用 CPU，相关问题可以参考 [ChatTTS-ui](https:\u002F\u002Fgithub.com\u002Fjianchang512\u002FChatTTS-ui) 项目中的说明\n\n## 报错速查\n\n1、`load_models() got an unexpected keyword argument 'source'`\n\n详见 **常见问题 - 模型无法下载**\n\n2、`cannot import name 'CommitOperationAdd' from 'huggingface_hub'`\n   \n详见 **常见问题 - 模型无法下载**\n\n3、 `FileNotFoundError：［Erzno 2］ No such file or directory： 'C：\\\\Users\\\\xxx\\\\.cache\\\\huggingface\\\\hub\\\\models--2Noise--ChatTTS\\\\snapshots\\`\n\n详见 **常见问题 - 模型无法下载**\n\n4、`local variable 'Normalizer' referenced before assignment`\n\n需要根据 **安装指南** 完成环境配置后，再安装 `pynini` 和 `WeTextProcessing` 依赖\n\n``` bash\nconda install -c conda-forge pynini=2.1.5 && pip install WeTextProcessing\n```\n\n5、`download to Local path D：\\pythonlproject\\ChatTTS\\ChatTTS failed.`\n\n在 IDE 中直接执行脚本，会因为文件路径问题报错，详见 **常见问题 - IDE 中无法运行**\n\n6、`ModuleNotFoundError : No module named'Cython'`\n\n未找到 Python 执行路径，Windows 设备需要按 [教程](https:\u002F\u002Fwww.cnblogs.com\u002Fajianbeyourself\u002Fp\u002F17654155.html) 配置环境路径\n\n\n## 项目趋势\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_readme_6001d18c8962.png)](https:\u002F\u002Fstar-history.com\u002F#libukai\u002FAwesome-ChatTTS&Date)","# Awesome-ChatTTS 快速上手指南\n\n## 1. 环境准备\n\n### 系统要求\n- **操作系统**：Windows \u002F Linux \u002F macOS (M1\u002FM2 需参考特定教程)\n- **GPU 要求**：推荐 NVIDIA 显卡，显存至少 **4GB**。若显存不足将强制使用 CPU，生成速度会显著变慢。\n- **Python 版本**：建议 Python 3.9 - 3.11\n\n### 前置依赖\n在开始之前，请确保已安装以下基础工具：\n- Git\n- Conda (推荐用于管理虚拟环境) 或 pip\n- FFmpeg (用于音频处理)\n\n> **注意**：部分中文文本处理依赖需要额外安装：\n> ```bash\n> conda install -c conda-forge pynini=2.1.5\n> pip install WeTextProcessing\n> ```\n\n## 2. 安装步骤\n\n### 方案 A：国内镜像加速安装（推荐）\n由于官方模型托管在 HuggingFace，国内访问可能受限。推荐使用魔塔社区（ModelScope）下载模型。\n\n1. **克隆项目代码**\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002F2noise\u002FChatTTS.git\n   cd ChatTTS\n   ```\n\n2. **安装 Python 依赖**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **安装 ModelScope 并下载模型**\n   ```bash\n   pip install modelscope\n   ```\n   \n   创建或修改启动脚本（如 `webui.py`），在文件头部加入以下代码以自动从国内源下载模型：\n   ```python\n   from modelscope import snapshot_download\n   # 下载模型到本地缓存\n   model_dir = snapshot_download('zlj2546\u002FChatTTS')\n   ```\n   \n   并在加载模型处指定自定义路径：\n   ```python\n   # 示例：在加载逻辑中\n   ret = chat.load_models('custom', custom_path=model_dir)\n   ```\n\n### 方案 B：标准安装\n若网络环境良好，可直接运行官方脚本，它会自动从 HuggingFace 拉取模型。\n\n```bash\npip install ChatTTS\n```\n\n## 3. 基本使用\n\n### 方式一：WebUI 可视化界面（最简单）\n适合初学者快速体验音色控制和文本生成。\n\n在项目根目录下执行：\n```bash\npython examples\u002Fweb\u002Fwebui.py\n```\n启动后浏览器会自动打开界面（通常为 `http:\u002F\u002F127.0.0.1:7860`）。\n- **输入文本**：支持中英文混合。\n- **音色控制**：点击 🎲 随机生成音色种子，或直接粘贴特定的音色码（Speaker Embedding）。\n- **生成音频**：点击 \"Generate\" 按钮，结果可在线播放或下载。\n\n### 方式二：命令行快速生成\n适合批量测试或脚本调用。\n\n```bash\npython examples\u002Fcmd\u002Frun.py \"你好，这是 ChatTTS 生成的语音。\" \"Hello, this is a test.\"\n```\n生成的音频文件将默认保存至当前目录下的 `.\u002Foutput_audio_n.mp3`。\n\n### 方式三：Python 代码调用（进阶）\n适用于集成到自己的应用中，支持精细控制音色和情感。\n\n```python\nimport torch\nimport ChatTTS\n\n# 初始化\nchat = ChatTTS.Chat()\n# 若使用本地模型路径\n# chat.load_models('custom', custom_path='你的本地模型路径')\nchat.load_models()\n\n# 准备音色 (示例：加载预设音色或使用压缩后的音色码)\n# spk_emb = torch.load(\"asset\u002Fseed_1332_restored_emb.pt\", map_location=torch.device('cpu')).detach()\nparams_infer_code = ChatTTS.Chat.InferCodeParams(\n    spk_emb=None,  # 若无特定音色可设为 None 随机生成\n    temperature=.0003,\n    top_P=0.7,\n    top_K=20,\n)\n\n# 生成音频\nwavs = chat.infer([\"今天天气真不错，适合出去走走。\"], params_infer_code=params_infer_code)\n\n# 保存音频 (需自行引入 scipy 或 soundfile 库保存 wav 数据)\n# import scipy.io.wavfile as wavf\n# wavf.write('output.wav', 24000, wavs[0])\n```\n\n## 4. 音色与参数调优提示\n\n- **音色稳定性**：直接使用随机种子每次生成的音色可能有细微差异。如需固定音色，建议保存生成的 `.pt` 音色文件或记录音色码字符串，下次直接复用。\n- **情感控制**：\n  - `temperature` (0-1)：值越大，情感波动越剧烈。\n  - `top_P` (0.1-0.9)：值越大，生成内容相关性越高。\n  - `top_K` (1-20)：值越小，生成内容相似性越高。\n- **口语化处理**：开启 \"Refine text\" 选项可让模型自动添加语气词（如“嗯”、“啊”），使语音更自然。","一位独立开发者正在为一款历史科普短视频应用批量生成多角色旁白，需要快速产出情感丰富且音色各异的音频素材。\n\n### 没有 Awesome-ChatTTS 时\n- **资源分散难查找**：需要在 GitHub、HuggingFace 和各类论坛间反复搜索，难以区分哪些是官方推荐资源，哪些是过时分支，耗费大量筛选时间。\n- **功能单一受限**：原生代码仅支持基础文本转语音，缺乏图形界面，无法直观调节情感波动（temperature）或口语化风格，导致生成的声音机械生硬。\n- **批量处理效率低**：面对几十集剧本，只能手动逐条运行脚本，不支持批量导出或自动生成字幕（SRT），后期对齐音画极其痛苦。\n- **音色克隆门槛高**：想要复刻特定历史人物声音，需自行整合 OpenVoice 等复杂模型，环境配置报错频发，新手极易劝退。\n\n### 使用 Awesome-ChatTTS 后\n- **一站式资源导航**：直接通过汇总页访问经过社区验证的热门分支（如 ChatTTS-ui 或 ChatTTS-Forge），秒级找到带 API 接口或增强降噪的版本。\n- **精细化情感操控**：利用集成好的 WebUI 界面，通过滑动条实时调整 `top_P` 和 `temperature` 参数，轻松让旁白呈现出“讲述感”或“激昂感”。\n- **自动化工作流**：调用支持批量处理的增强版项目，一次性导入整季剧本，自动输出音频与对应的 SRT 字幕文件，制作效率提升十倍。\n- **低代码音色定制**：借助集成的音色克隆教程与工具，无需深究底层代码，仅需上传少量样本即可实现特定角色的声音复刻，快速丰富内容维度。\n\nAwesome-ChatTTS 将零散的技术碎片整合为高效的生产力工具箱，让创作者从繁琐的环境配置中解放，专注于内容本身的创新。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flibukai_Awesome-ChatTTS_e5ca069c.png","libukai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Flibukai_e5fd0184.png",null,"AI Seed","Wuhan,China","xiaobuyao@gmail.com","https:\u002F\u002Faiseed.org.cn","https:\u002F\u002Fgithub.com\u002Flibukai",1857,116,"2026-04-05T13:06:32","Linux, macOS, Windows","非必需，但推荐 NVIDIA GPU；若使用 GPU，显存至少需要 4GB，否则强制使用 CPU。未明确指定具体显卡型号和 CUDA 版本。","未说明",{"notes":87,"python":88,"dependencies":89},"1. 模型默认从 HuggingFace 下载，若网络受限可改用 ModelScope 下载并配置本地路径。2. 首次运行需下载模型文件，建议确保网络连接顺畅或提前离线下载。3. 在 IDE 中运行可能因相对路径问题报错，建议在终端中于项目根目录下执行命令。4. 部分中文标点符号可能导致生成错误，需手动处理或修改代码补充映射。5. 音色控制建议使用预生成的 .pt 文件或音色码以获得更稳定效果。","未说明（需支持 torch 和 modelscope 等库）",[90,91,92,93,94],"torch","modelscope","pynini==2.1.5","WeTextProcessing","Cython",[96,13,14,35,15],"音频",[98,99],"ai","chattts","2026-03-27T02:49:30.150509","2026-04-07T00:49:47.844684",[],[]]