Bing Bong's helper
==================

A small program that runs Bing Bong's voice, speech recognition and a text AI on your own computer. Then Bing Bong works without the internet and without paid services. The AI models are not part of the mod; you get them separately.

To open it: in the game F6 → the AI tab → Helper. Or BingBongHelper.exe in this folder.

1. Text AI. Install LM Studio (lmstudio.ai) and download a model in it, for example Qwen 3.5 9B or Gemma 4 E4B (lighter). In the helper: Settings → Text AI → pick the model.

2. Voice. Download a Piper voice, two files (.onnx and .onnx.json), from huggingface.co/rhasspy/piper-voices (in English, for example, en_US-lessac-medium). In the helper: Settings → Voice → Open the voices folder, and put them there.

3. Spoken questions, if you like. Download whisper.cpp (github.com/ggml-org/whisper.cpp/releases) and the model ggml-large-v3-turbo.bin (huggingface.co/ggerganov/whisper.cpp). In the helper: Settings → Recognition → choose whisper-server.exe and the model.

4. Press Start all. A green dot means it runs.

5. In the game: F6 → AI → Everything on my PC.

A graphics card with 8 GB of memory or more is best: the AI runs next to the game.

The built-in Piper cannot read the Chinese voices zh_CN-chaowen and zh_CN-xiao_ya, or Japanese, Hebrew and Thai voices. For those: Settings → Voice → Piper through Python; it needs Python and the command pip install piper-tts.
