Murder.Ai

Murder.Ai

Plays a detective game where you question AI suspects, gather evidence and solve generated murder mysteries, for fans of interactive mystery games.

Made by MCP-1st-Birthday on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: Murder.Ai is a detective game driven by language models. You question suspects, collect evidence and try to solve a murder mystery that the game generates. Each suspect has a personality, secrets and a voice. The game also has a mode where an AI detective plays the case while you watch.

Who it suits: Players who like mystery games and people who want to see how language models and MCP tools can run a game.

Industry | Who uses it | How they use it | Example
Gaming | Mystery fans | Play the detective and question AI suspects | Working through the Silicon Valley Incident case
Software | Developers of agent games | Study a game built on MCP tools and Gradio | Reading how the tools reach the Python engine
Education | People learning about AI agents | Watch an AI detective reason through evidence | Using the spectator mode to follow its accusations

If you want a short, offline game that needs no accounts or keys for a copy, you can skip it.

Where to use it:

• A web browser, on the Space's page at Hugging Face
• Docker on Windows, macOS or Linux, for a copy you run yourself

Use case | Who | What they get back
Play a case | Mystery fans | A case to investigate, with suspects to question
Speak your questions | Players | Interrogation by voice through the browser's speech recognition
Watch the AI play | Curious viewers | An AI detective that reasons through evidence and accuses

How to set it up: Online, nothing needs installing. A copy on your own computer needs Docker, a little Python and two service keys.

• Docker
• Python and the pip tool, only for the download step
• A Gemini key and an ElevenLabs key for the language model and the voices

1. Install the Hugging Face hub package.
2. Download the Space's files into a folder.
3. Move into that folder.
4. Build the Docker image.
5. Run the container with port 7860 open.
6. Provide the two keys as environment variables.

pip install -U huggingface_hub
hf download MCP-1st-Birthday/Murder.Ai --repo-type space --local-dir Murder.Ai
cd Murder.Ai
docker build -t murder.ai .
docker run -it -p 7860:7860 murder.ai

The project's notes name the two keys in a .env file like this. Replace the placeholders with your own keys.

Put your own value in GEMINI_API_KEY and ELEVENLABS_API_KEY first.

How to use it: Pick a case, gather evidence with the tools, then question the suspects by text or voice. Once you believe you have the answer, you can accuse a suspect. A wrong accusation costs you rounds. The game runs on port 7860.

docker run -it -p 7860:7860 murder.ai

Tool | What it does
get_location(phone) | Works out where a suspect was, from a phone
get_footage(camera) | Plays security footage, which can reveal physical evidence
get_dna_test(item) | Checks an object for fingerprints and DNA
call_alibi(id) | Calls an alibi witness, played by a second language model agent

Example: You pick the Art Gallery Heist case and watch the footage from one camera. You then ask the curator out loud where they were that night. The curator answers in a voice that suits their role, and you decide whether to accuse or keep digging.

For newcomers and experts: Think of it as a chat-based whodunit. To start, pick a case, check the evidence once, then ask a suspect one simple question about the night in question.

Its tools come from the Model Context Protocol, which lets both the AI and the player call them. A custom HTML, CSS and JavaScript interface sits inside Gradio, a FastAPI backend holds the game state, and a Python engine runs the logic. A bridge links the browser to the backend. The badges name Gemini 2.5 Flash as the language model.

Pick a case
Gather evidence with the MCP tools
Question suspects by text or voice
Make an accusation

Good to know:

• Limits: the AI spectator mode is marked beta, and a wrong accusation costs you rounds
• License: GPL 3
• Cost to run: a Gemini key and an ElevenLabs key are named, and both services may charge for use
• Data it reaches: your typed or spoken questions, which go to the language model and the voice service, and speech recognition in your browser
• Not for: the source names no forbidden uses

On Hugging Face, 13 November 2026

• Likes: 60
• Built with: docker
• License: gpl-3.0

Links

• Space: https://huggingface.co/spaces/MCP-1st-Birthday/Murder.Ai
• Files: https://huggingface.co/spaces/MCP-1st-Birthday/Murder.Ai/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.