{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "christos-antono-npctalk--make-game-npcs-talk-back",
 "repo": "christos-antono/NPCTalk",
 "repo_url": "https://github.com/christos-antono/NPCTalk",
 "repo_slug": "christos-antono-npctalk",
 "title": "Make an NPC in your own game answer you in character",
 "page_title": "How to make an NPC in your own game answer you in character with NPC Talk",
 "summary": "Install the skills, stand up the voice server and get one NPC replying in a cloned voice.",
 "who": "A solo modder with a single-player game they own, who wants one NPC to answer typed or spoken questions with a voice.",
 "problem": "Wiring an LLM, a text-to-speech server and game hooks together by hand takes many separate setups that are easy to get wrong.",
 "outcome": "One NPC in the game replies to the player in character, in a cloned voice, roughly a second after the player speaks.",
 "steps": [
  "Install the skills and CLI in your agent: `uv tool install git+https://github.com/christos-antono/NPCTalk` (or clone the repo and start your agent inside it).",
  "Set up Modal with `modal setup`, then put the value of NPCVOICE_TOKEN into the npcvoice-auth secret.",
  "Check that the voice server is up with `npctalk health`, then speak a test line with `npctalk say`.",
  "Ask the make-npcs-talk skill to build the four game hooks (who is talked to, scene facts, voice at the NPC, actions) for one NPC only.",
  "Test in the game, and log each step's timing as the skill's verification step asks."
 ],
 "agent_prompt": "Using the NPCTalk repo at https://github.com/christos-antono/NPCTalk, start the make-npcs-talk skill and make the NPC <npc-name> in <game-name> answer typed questions in a voice. Expected output: a working speak loop and a WAV from `npctalk say`. Verify that `npctalk health` reports the voice server up before testing the game.",
 "agents": [
  "claude-code",
  "codex",
  "cursor",
  "gemini-cli"
 ],
 "difficulty": "Advanced",
 "time": "4 hours",
 "basis": "readme",
 "caveat": "The README says the voice server URL should stay private because its /health endpoint wakes the GPU, so keep it out of commits and shared logs.",
 "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": "credentials",
   "notice": "Modal, fal, Cerebras and TypeSafe keys must come from environment variables, never from files in the repo."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/christos-antono-npctalk/make-game-npcs-talk-back/",
 "md": "https://dedupedai.com/use-cases/christos-antono-npctalk/make-game-npcs-talk-back/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--make-game-npcs-talk-back.json",
 "api_version": "v1"
}