christos-antono/NPCTalk

选用指南

AI 根据 README 整理 · 2026/10/17 01:50:58

适用场景

适用于希望为单机游戏或自有服务器添加可对话 NPC 的开发者或模组制作者，特别是 GTA V 等游戏。

查看 README 依据

Built first for **GTA V**: walk up to anyone in Los Santos and just talk. Lamar roasts your hoodie, a cop tells you to file a civil claim and flips you off, Michael defends his robe like it's a business suit. Every line is written live in character and spoken in that character's cloned voice by **Fish Audio Drama 3** (or **S2 Pro**), self-hosted on a serverless GPU. Most of the code doesn't know it's in GTA, so the same pieces work in other games: the skills say what a game has to provide, and how to build the rest. ## Install

Without training, Drama 3 and S2 Pro tie on likeness; Drama 3 acts `[crying]` and `[laughing]` better and starts talking faster. One early result here didn't survive a second run: [how that was caught](docs/how-it-was-made.md#6-making-the-voice-sound-right-and-being-honest-about-it). ## Rules it follows - **Single-player games, or servers you run.** It never injects into online games with anti-cheat (GTA V: never launch GTA Online with a script hook installed) and never bypasses anti-cheat, DRM or ownership checks.

目标用户

面向使用 AI 编码代理（如 Claude Code、Codex 等）的开发者，以及游戏模组制作者。

查看 README 依据

<p align="center"> <a href="#install">Claude Code · Codex · Cursor · Gemini CLI · Copilot · OpenCode</a> · <a href="docs/how-it-was-made.md">how it was made</a> · <a href="examples/gta-v">GTA V example</a> · <a href="https://discord.com/invite/sEZWaf7vV">Discord</a> · <a href="LICENSE">MIT</a> </p>

Pick your agent. Each gets the same skills (Agent Skills format), the fal MCP server and the `npctalk` CLI. | Agent | Install | |---|---| | **Claude Code** | `/plugin marketplace add christos-antono/NPCTalk`<br>`/plugin install npctalk@npctalk` | | **Codex** | `codex plugin marketplace add christos-antono/NPCTalk`<br>`codex plugin add npctalk@npctalk` | | **Gemini CLI** | `gemini extensions install https://github.com/christos-antono/NPCTalk` | | **VS Code / Copilot** | Enable `chat.plugins.enabled`, run **Chat: Install Plugin From Source**, enter this repo's URL |

使用方式

通过插件市场或克隆仓库安装，使用 npctalk CLI 和技能文件，需要配置 Modal、fal、Cerebras 等外部服务。

查看 README 依据

Pick your agent. Each gets the same skills (Agent Skills format), the fal MCP server and the `npctalk` CLI. | Agent | Install | |---|---| | **Claude Code** | `/plugin marketplace add christos-antono/NPCTalk`<br>`/plugin install npctalk@npctalk` | | **Codex** | `codex plugin marketplace add christos-antono/NPCTalk`<br>`codex plugin add npctalk@npctalk` | | **Gemini CLI** | `gemini extensions install https://github.com/christos-antono/NPCTalk` | | **VS Code / Copilot** | Enable `chat.plugins.enabled`, run **Chat: Install Plugin From Source**, enter this repo's URL |

**The `npctalk` CLI.** Plugin installs and clones put it on PATH (`bin/`). Anywhere else: `uv tool install git+https://github.com/christos-antono/NPCTalk`. **Accounts and keys** (environment variables, never files): | What for | Service | Variable | |---|---|---| | The voice server (GPU) | [Modal](https://modal.com) | `modal setup`; `NPCVOICE_TOKEN` = the value you put in the `npcvoice-auth` secret | | Speech-to-text, MiniMax voices, the MCP server | [fal](https://fal.ai/dashboard/keys) | `FAL_KEY` |

部署要求

需要 Git、Python 3.10+、uv 和 ffmpeg；GTA V 示例需要 Windows、.NET SDK 8+ 和游戏本身。

查看 README 依据

| The NPC's lines (any OpenAI-compatible LLM) | [Cerebras](https://cloud.cerebras.ai) | `CEREBRAS_API_KEY` | | Actions and spoken orders | [TypeSafe](https://docs.typesafe.ai) | `TYPESAFE_API_KEY` | You also need Git, Python 3.10+, `uv` and ffmpeg. The GTA V example needs Windows, the .NET SDK (8+) to build it, and the game. ## Try it > Make the villagers in my game answer when I talk to them, in their own voices. > Set up a Fish Audio Drama 3 voice server on Modal and clone a voice from `narrator.wav`. > In GTA V story mode, let me talk to anyone near me with my mic.

已知限制

仅支持单机游戏或自有服务器，不注入在线游戏或绕过反作弊、DRM 或所有权检查。

查看 README 依据

Without training, Drama 3 and S2 Pro tie on likeness; Drama 3 acts `[crying]` and `[laughing]` better and starts talking faster. One early result here didn't survive a second run: [how that was caught](docs/how-it-was-made.md#6-making-the-voice-sound-right-and-being-honest-about-it). ## Rules it follows - **Single-player games, or servers you run.** It never injects into online games with anti-cheat (GTA V: never launch GTA Online with a script hook installed) and never bypasses anti-cheat, DRM or ownership checks.