{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "nyosegawa-speech-cpp--generate-narration-audio-from-text",
 "repo": "nyosegawa/speech.cpp",
 "repo_url": "https://github.com/nyosegawa/speech.cpp",
 "repo_slug": "nyosegawa-speech-cpp",
 "title": "Generate spoken narration audio from a text file",
 "page_title": "How to generate spoken narration audio from a text file with Speech CPP",
 "summary": "Turn a script into a WAVE file of speech using a local Qwen3-TTS voice.",
 "who": "A content creator, teacher or developer who needs narration for a video, lesson or prototype and wants to avoid a paid voice service.",
 "problem": "Recording narration takes time, and cloud text-to-speech may be costly or send private scripts off the machine.",
 "outcome": "A WAVE file with the spoken text, produced locally from a named voice.",
 "steps": [
  "Install speech using the installer for your platform.",
  "Run `speech tts qwen3-tts-0.6b --voice ryan -o hello.wav \"Hello. It will be sunny in Tokyo tomorrow.\"` to make the first file. The model is fetched the first time.",
  "Replace the quoted text with your own sentence, or pipe a file to stdout with `speech tts qwen3-tts-0.6b --voice ryan -o -` (inferred from the README's note that output can go to stdout). (inferred, check the README)",
  "Play hello.wav and check the pronunciation."
 ],
 "agent_prompt": "Using the nyosegawa/speech.cpp repo, install speech and run `speech tts qwen3-tts-0.6b --voice ryan -o <output>.wav \"<script text>\"`. Expected output: a WAVE file at the path given, with the script spoken in the ryan voice. Verify that the file plays and matches the script.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The first run downloads a 1.21 GB model, so plan for that time and disk space before generating audio.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "c++",
 "requirements": [
  "macOS on Apple silicon, Linux on x86-64, or Windows x64",
  "Internet access to fetch the installer and models from Hugging Face the first time",
  "Free disk space for the model files, for example 1.21 GB for qwen3-tts-0.6b",
  "A terminal (PowerShell on Windows)",
  "A microphone, for live transcription"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "remote-script",
   "notice": "The install step runs a script fetched from the internet, so review it before running."
  }
 ],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/nyosegawa-speech-cpp/generate-narration-audio-from-text/",
 "md": "https://dedupedai.com/use-cases/nyosegawa-speech-cpp/generate-narration-audio-from-text/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/nyosegawa-speech-cpp--generate-narration-audio-from-text.json",
 "api_version": "v1"
}