{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "christos-antono-npctalk--measure-npc-voice-likeness",
 "repo": "christos-antono/NPCTalk",
 "repo_url": "https://github.com/christos-antono/NPCTalk",
 "repo_slug": "christos-antono-npctalk",
 "title": "Measure whether an NPC voice change really helped",
 "page_title": "How to measure whether an NPC voice change really helped with NPC Talk",
 "summary": "Use the voice-likeness-eval skill to score a cloned voice against held-out real clips before claiming it improved.",
 "who": "A modder tuning cloned NPC voices who keeps hearing mixed opinions on whether a change sounds better.",
 "problem": "Judging voice quality by ear is unreliable, and a thin-sounding clone could come from the reference clip or the model.",
 "outcome": "Speaker similarity and word error numbers over enough runs, showing whether the change helped.",
 "steps": [
  "Install the skills, for example `npx skills add https://github.com/christos-antono/NPCTalk`",
  "Check the voice server with npctalk health",
  "Ask the voice-likeness-eval skill to measure the current voice against held-out real clips",
  "Make your change (new reference clip, settings or model) and measure again",
  "Keep the change only if similarity improves across enough runs"
 ],
 "agent_prompt": "Using christos-antono/NPCTalk's voice-likeness-eval skill, measure speaker similarity and word error for my NPC voice <name> before and after switching the reference clip, over enough runs to be confident, and tell me which to keep.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Intermediate",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "",
 "category": "Games and hobbies",
 "tags": [
  "Games and hobbies"
 ],
 "lang": "python",
 "requirements": [
  "A game you own, ideally single-player (the README says never inject into online games with anti-cheat)",
  "Git, Python 3.10+, uv and ffmpeg",
  "A Modal account for the GPU voice server, with the NPCVOICE_TOKEN environment variable set",
  "A fal key (FAL_KEY) for speech-to-text and the MCP server",
  "A Cerebras key (CEREBRAS_API_KEY) for the NPC's lines",
  "Optional: a TypeSafe key (TYPESAFE_API_KEY) for actions and spoken orders",
  "Windows and the .NET SDK (8+) only if you follow the GTA V example"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "voice-cloning",
   "notice": "Only clone and evaluate voices from recordings you have the rights to."
  }
 ],
 "best": false,
 "score": 0.75,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/christos-antono-npctalk/measure-npc-voice-likeness/",
 "md": "https://dedupedai.com/use-cases/christos-antono-npctalk/measure-npc-voice-likeness/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/christos-antono-npctalk--measure-npc-voice-likeness.json",
 "api_version": "v1"
}
