{"id":50455116,"url":"https://github.com/gitstq/voxforge-cli","last_synced_at":"2026-06-01T02:00:53.090Z","repository":{"id":361720350,"uuid":"1255539496","full_name":"gitstq/VoxForge-CLI","owner":"gitstq","description":"🎙️ VoxForge-CLI - Lightweight Terminal Multilingual Text-to-Speech Engine | 轻量级终端多语言语音合成引擎","archived":false,"fork":false,"pushed_at":"2026-06-01T00:14:07.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T02:00:36.306Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/gitstq/VoxForge-CLI","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T00:13:19.000Z","updated_at":"2026-06-01T00:13:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"367b4815-da79-4b86-814d-77fa70c53917","html_url":"https://github.com/gitstq/VoxForge-CLI","commit_stats":null,"previous_names":["gitstq/voxforge-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/VoxForge-CLI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2FVoxForge-CLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2FVoxForge-CLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2FVoxForge-CLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2FVoxForge-CLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/VoxForge-CLI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2FVoxForge-CLI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33756581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-01T02:00:35.122Z","updated_at":"2026-06-01T02:00:53.057Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎙️ VoxForge-CLI\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![GitHub stars](https://img.shields.io/github/stars/gitstq/VoxForge-CLI.svg?style=social)](https://github.com/gitstq/VoxForge-CLI/stargazers)\n\n**[简体中文](#简体中文) | [繁體中文](#繁體中文) | [English](#english)**\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n## 🎉 项目介绍\n\n**VoxForge-CLI** 是一款轻量级终端多语言语音合成引擎，专为开发者和内容创作者设计。支持多种TTS后端、声音设计、声音克隆、批量处理和流式输出。\n\n### ✨ 核心特性\n\n- 🌍 **多语言支持** — 支持30+种语言，包括中文、英语、日语、韩语等\n- 🎨 **声音设计** — 通过自然语言描述创建全新声音，无需参考音频\n- 🎛️ **声音克隆** — 从短音频片段克隆任意声音\n- 🚀 **多后端支持** — 支持 Edge TTS、OpenAI、VoxCPM 等多种后端\n- 📦 **批量处理** — 高效批量文本转语音，支持并行处理\n- 🎚️ **精细控制** — 语速、音调、风格等参数可调\n- 💾 **声音库管理** — 保存、加载、导入导出声音配置文件\n- ⚡ **零依赖核心** — 核心功能无需复杂依赖，开箱即用\n\n### 🎯 解决的痛点\n\n- 传统TTS工具配置复杂，上手门槛高\n- 缺乏统一的命令行工具进行批量处理\n- 声音参数调整需要反复尝试，效率低下\n- 多语言项目需要切换不同工具\n\n### 💡 自研差异化亮点\n\n- **智能声音设计**：通过自然语言描述自动生成声音配置\n- **统一CLI接口**：一个命令行工具搞定所有TTS需求\n- **中文优化**：针对中文场景深度优化，支持方言\n- **配置持久化**：声音配置一键保存复用\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n\n- Python 3.10 或更高版本\n- pip 包管理器\n\n### 安装\n\n```bash\n# 使用 pip 安装\npip install voxforge-cli\n\n# 或从源码安装\ngit clone https://github.com/gitstq/VoxForge-CLI.git\ncd VoxForge-CLI\npip install -e .\n```\n\n### 快速使用\n\n```bash\n# 显示帮助\nvoxforge --help\n\n# 简单语音合成\nvoxforge say \"你好，世界！\"\n\n# 指定语言和语速\nvoxforge say \"Hello, world!\" -l en-US -s 1.2\n\n# 从文件读取并输出\nvoxforge say -f article.txt -o output.wav\n\n# 列出可用声音\nvoxforge voice list\n\n# 设计新声音\nvoxforge design \"一位温柔的女性声音\" --save\n```\n\n---\n\n## 📖 详细使用指南\n\n### 基础命令\n\n#### 🗣️ 语音合成 (say)\n\n```bash\n# 基础合成\nvoxforge say \"要合成的文本\"\n\n# 指定输出文件\nvoxforge say \"保存到文件\" -o output.wav\n\n# 从文件读取文本\nvoxforge say -f input.txt -o output.wav\n\n# 指定后端引擎\nvoxforge say \"使用OpenAI\" -b openai\n\n# 调整语速\nvoxforge say \"快速语音\" -s 1.5\n\n# 指定语言\nvoxforge say \"日本語テスト\" -l ja-JP\n```\n\n#### 🎤 声音管理 (voice)\n\n```bash\n# 列出所有声音\nvoxforge voice list\n\n# 筛选声音\nvoxforge voice list -l zh -g female\n\n# 创建新声音\nvoxforge voice create my-voice -l zh-CN -g female -s calm\n\n# 查看声音详情\nvoxforge voice show my-voice\n\n# 删除声音\nvoxforge voice delete my-voice\n```\n\n#### 🎨 声音设计 (design)\n\n```bash\n# 从描述设计声音\nvoxforge design \"一位年轻女性，声音温柔甜美\"\n\n# 指定目标语言\nvoxforge design \"An elderly man with deep voice\" -l en-US\n\n# 保存设计的声音\nvoxforge design \"专业男声\" --save -n professional-male\n```\n\n#### 🎙️ 声音克隆 (clone)\n\n```bash\n# 从参考音频克隆\nvoxforge clone \"要合成的文本\" -r reference.wav -o cloned.wav\n```\n\n#### 📦 批量处理 (batch)\n\n```bash\n# 创建输入文件（每行一段文本）\necho -e \"第一句\\n第二句\\n第三句\" \u003e texts.txt\n\n# 批量处理\nvoxforge batch texts.txt -o ./output\n\n# 并行处理\nvoxforge batch texts.txt -o ./output --parallel\n```\n\n### Python API\n\n```python\nfrom voxforge import TTSEngine, VoiceProfile, VoiceManager\n\n# 初始化引擎\nengine = TTSEngine()\n\n# 简单合成\nresult = engine.synthesize(\"你好，世界！\")\nprint(f\"输出文件: {result.audio_path}\")\nprint(f\"时长: {result.duration_seconds}秒\")\n\n# 使用自定义声音\nvoice = VoiceProfile(\n    name=\"custom\",\n    language=\"zh-CN\",\n    gender=\"female\",\n    style=\"calm\",\n    speed=1.2\n)\nresult = engine.synthesize(\"自定义声音测试\", voice=voice)\n\n# 声音设计\nfrom voxforge.models import VoiceDesignRequest\nrequest = VoiceDesignRequest(\n    description=\"一位活泼开朗的年轻女孩\",\n    language=\"zh-CN\"\n)\nprofile = engine.design_voice(request)\n\n# 批量处理\ntexts = [\"第一句\", \"第二句\", \"第三句\"]\nresults = engine.batch_synthesize(texts, output_dir=\"./output\")\n\n# 声音管理\nvm = VoiceManager()\nvm.create_default_voices()  # 创建默认声音\nvoices = vm.list_voices()   # 列出所有声音\n```\n\n### 配置说明\n\n```bash\n# 查看当前配置\nvoxforge config\n\n# 环境变量配置\nexport VOXFORGE_DEFAULT_LANGUAGE=zh-CN\nexport VOXFORGE_DEFAULT_SPEED=1.0\nexport VOXFORGE_OUTPUT_DIR=./output\n```\n\n---\n\n## 💡 设计思路与迭代规划\n\n### 设计理念\n\nVoxForge-CLI 的设计遵循以下原则：\n\n1. **简洁优先**：命令行界面直观易用，降低学习成本\n2. **模块化架构**：核心引擎与后端解耦，易于扩展\n3. **配置即代码**：声音配置可序列化，便于版本管理\n4. **渐进增强**：基础功能零依赖，高级功能可选安装\n\n### 技术选型\n\n| 组件 | 选择 | 原因 |\n|------|------|------|\n| CLI框架 | Click | 成熟稳定，支持复杂命令结构 |\n| 终端美化 | Rich | 提供丰富的终端输出格式 |\n| 数据验证 | Pydantic | 类型安全，自动验证 |\n| HTTP客户端 | httpx | 现代异步支持，性能优秀 |\n\n### 后续迭代计划\n\n- [ ] WebUI 界面支持\n- [ ] 更多TTS后端集成\n- [ ] 实时语音流处理\n- [ ] 声音效果后处理\n- [ ] 多说话人对话生成\n\n---\n\n## 📦 打包与部署指南\n\n### 本地开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/gitstq/VoxForge-CLI.git\ncd VoxForge-CLI\n\n# 创建虚拟环境\npython -m venv .venv\nsource .venv/bin/activate  # Linux/macOS\n# .venv\\Scripts\\activate   # Windows\n\n# 安装开发依赖\npip install -e \".[dev]\"\n\n# 运行测试\npytest\n\n# 代码检查\nruff check .\nmypy src/\n```\n\n### 构建发布\n\n```bash\n# 构建 wheel 包\npip install build\npython -m build\n\n# 发布到 PyPI\npip install twine\ntwine upload dist/*\n```\n\n### Docker 部署\n\n```dockerfile\nFROM python:3.12-slim\n\nWORKDIR /app\nCOPY . .\nRUN pip install --no-cache-dir .\n\nENTRYPOINT [\"voxforge\"]\n```\n\n---\n\n## 🤝 贡献指南\n\n我们欢迎所有形式的贡献！\n\n### 如何贡献\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: 添加新功能'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n### 提交规范\n\n遵循 [Angular 提交规范](https://github.com/angular/angular/blob/master/CONTRIBUTING.md#commit)：\n\n- `feat:` 新功能\n- `fix:` 修复问题\n- `docs:` 文档更新\n- `refactor:` 代码重构\n- `test:` 测试相关\n- `chore:` 构建/工具相关\n\n---\n\n## 📄 开源协议\n\n本项目基于 [MIT 协议](LICENSE) 开源，可自由用于商业和个人项目。\n\n---\n\n**灵感来源**：本项目受到 VoxCPM、Edge-TTS 等优秀开源项目的启发，采用完全自研开发，专注于提供轻量级、易用的命令行TTS解决方案。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n## 🎉 專案介紹\n\n**VoxForge-CLI** 是一款輕量級終端多語言語音合成引擎，專為開發者和內容創作者設計。支援多種TTS後端、聲音設計、聲音複製、批次處理和串流輸出。\n\n### ✨ 核心特性\n\n- 🌍 **多語言支援** — 支援30+種語言，包括中文、英語、日語、韓語等\n- 🎨 **聲音設計** — 透過自然語言描述建立全新聲音，無需參考音訊\n- 🎛️ **聲音複製** — 從短音訊片段複製任意聲音\n- 🚀 **多後端支援** — 支援 Edge TTS、OpenAI、VoxCPM 等多種後端\n- 📦 **批次處理** — 高效批次文字轉語音，支援並行處理\n- 🎚️ **精細控制** — 語速、音調、風格等參數可調\n- 💾 **聲音庫管理** — 儲存、載入、匯入匯出聲音設定檔\n- ⚡ **零依賴核心** — 核心功能無需複雜依賴，開箱即用\n\n### 🚀 快速開始\n\n```bash\n# 安裝\npip install voxforge-cli\n\n# 簡單語音合成\nvoxforge say \"你好，世界！\"\n\n# 指定語言和語速\nvoxforge say \"Hello, world!\" -l en-US -s 1.2\n\n# 設計新聲音\nvoxforge design \"一位溫柔的女性聲音\" --save\n```\n\n### 📖 詳細使用指南\n\n```bash\n# 列出可用聲音\nvoxforge voice list\n\n# 建立自訂聲音\nvoxforge voice create my-voice -l zh-TW -g female -s calm\n\n# 批次處理\nvoxforge batch texts.txt -o ./output\n\n# 聲音複製\nvoxforge clone \"要合成的文字\" -r reference.wav -o cloned.wav\n```\n\n### 📄 開源協議\n\n本專案基於 [MIT 協議](LICENSE) 開源。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🎉 Introduction\n\n**VoxForge-CLI** is a lightweight terminal multilingual Text-to-Speech engine designed for developers and content creators. It supports multiple TTS backends, voice design, voice cloning, batch processing, and streaming output.\n\n### ✨ Key Features\n\n- 🌍 **Multilingual Support** — 30+ languages including Chinese, English, Japanese, Korean, etc.\n- 🎨 **Voice Design** — Create new voices from natural language descriptions, no reference audio needed\n- 🎛️ **Voice Cloning** — Clone any voice from short audio clips\n- 🚀 **Multiple Backends** — Support Edge TTS, OpenAI, VoxCPM, and more\n- 📦 **Batch Processing** — Efficient batch text-to-speech with parallel support\n- 🎚️ **Fine Control** — Adjustable speed, pitch, style parameters\n- 💾 **Voice Library** — Save, load, import/export voice profiles\n- ⚡ **Zero-Dependency Core** — Core functionality works out of the box\n\n### 🚀 Quick Start\n\n```bash\n# Install\npip install voxforge-cli\n\n# Simple synthesis\nvoxforge say \"Hello, world!\"\n\n# Specify language and speed\nvoxforge say \"你好，世界！\" -l zh-CN -s 1.2\n\n# Design new voice\nvoxforge design \"A gentle female voice\" --save\n```\n\n### 📖 Usage Guide\n\n```bash\n# List available voices\nvoxforge voice list\n\n# Create custom voice\nvoxforge voice create my-voice -l en-US -g female -s calm\n\n# Batch processing\nvoxforge batch texts.txt -o ./output\n\n# Voice cloning\nvoxforge clone \"Text to synthesize\" -r reference.wav -o cloned.wav\n```\n\n### Python API\n\n```python\nfrom voxforge import TTSEngine, VoiceProfile\n\n# Initialize engine\nengine = TTSEngine()\n\n# Simple synthesis\nresult = engine.synthesize(\"Hello, world!\")\nprint(f\"Output: {result.audio_path}\")\n\n# Custom voice\nvoice = VoiceProfile(\n    name=\"custom\",\n    language=\"en-US\",\n    gender=\"female\",\n    style=\"calm\",\n    speed=1.2\n)\nresult = engine.synthesize(\"Custom voice test\", voice=voice)\n```\n\n### 📄 License\n\nThis project is open-sourced under the [MIT License](LICENSE).\n\n---\n\n**Inspiration**: This project is inspired by excellent open-source projects like VoxCPM and Edge-TTS, developed independently focusing on providing a lightweight, easy-to-use command-line TTS solution.\n\n**Star ⭐ this repo if you find it helpful!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fvoxforge-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fvoxforge-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fvoxforge-cli/lists"}