Spaces:
Running on Zero
Running on Zero
| title: ID | |
| emoji: 🔍 | |
| colorFrom: gray | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: 6.18.0 | |
| python_version: "3.12" | |
| app_file: app.py | |
| pinned: false | |
| tags: | |
| - track:wood | |
| - sponsor:openbmb | |
| - sponsor:openai | |
| - achievement:offgrid | |
| - achievement:offbrand | |
| - achievement:llama | |
| # ID | |
| A small Gradio build of the LLM-driven investigation game. Question suspects, | |
| search rooms, catch contradictions, and make an accusation. | |
| ## Small-model, no-API by default | |
| The Space runs **entirely on a small local model** — OpenBMB | |
| [MiniCPM4.1-8B](https://huggingface.co/openbmb/MiniCPM4.1-8B) (~8B params) through the | |
| **llama.cpp** runtime. No cloud API and no user credentials are needed; the GGUF | |
| is downloaded from the Hub on first launch. | |
| Recommended hardware: **ZeroGPU** (set it in the Space's *Settings → Hardware*). | |
| Generation runs inside an `@spaces.GPU` function, so it uses the GPU on ZeroGPU | |
| and falls back to CPU/Metal elsewhere. Worlds are pre-generated and committed | |
| under `worlds/`, so play time only runs the light tiers (character, extractor, | |
| guard, environment, judge). | |
| ### Optional configuration (Space variables) | |
| - `F_ID_GGUF_REPO` / `F_ID_GGUF_FILE`: override the model repo / GGUF glob | |
| (defaults to `openbmb/MiniCPM4.1-8B-GGUF`, a Q4_K_M quant) | |
| - `F_ID_N_GPU_LAYERS`: layers to offload (`-1` = all, `0` = CPU only) | |
| - `F_ID_CTX`: context window (default `16384`) | |
| - `F_ID_ENABLE_THINKING`: enable the model's hybrid `<think>` reasoning | |
| (default off; reasoning is disabled to keep turns fast) | |
| ### Using a hosted API instead (optional) | |
| The engine is provider-agnostic. To point at an OpenAI-compatible endpoint set: | |
| - `F_ID_PROVIDER`: `openai`, `openrouter`, or `local` (default `local`) | |
| - `F_ID_MODEL`: model name | |
| - `F_ID_BASE_URL`: OpenAI-compatible API base URL | |
| - `F_ID_API_KEY_ENV`: name of the Space secret holding the key | |
| ### More | |
| A CLI version is also available, you can find it here together with the full repository: [GitHub - f-id](https://github.com/marcodsn/f-id) | |
| Demo video link: https://youtu.be/bjLddFEGX9I | |
| Social post link: https://www.reddit.com/r/huggingface/comments/1u5l1dp/fid_an_llmdriven_investigation_game/ | |