Update README and app.py for enhanced game description and tool usage instructions

README.md

@@ -1,5 +1,5 @@
 ---
-title: Murder.Ai
+title: Murder.Ai - LLMs that kill, lie, decieve
 emoji: 🕵️🔥🤖🔪
 colorFrom: red
 colorTo: gray
@@ -11,4 +11,86 @@ tags:
   - building-mcp-track-creative
   - mcp-in-action-track-creative
 ---
-- Read `PLan.md`
+
+# 🕵️ Murder.Ai - Interactive AI Mystery
+
+[![Gemini](https://img.shields.io/badge/LLM-Gemini%202.5%20Flash-blue)](https://deepmind.google/technologies/gemini/)
+[![Anthropic](https://img.shields.io/badge/MCP-Anthropic-purple)](https://www.anthropic.com/)
+[![ElevenLabs](https://img.shields.io/badge/Voice-ElevenLabs-lightgrey)](https://elevenlabs.io)
+[![Gradio](https://img.shields.io/badge/Frontend-Gradio-orange)](https://gradio.app)
+[![FastAPI](https://img.shields.io/badge/Backend-FastAPI-green)](https://fastapi.tiangolo.com/)
+
+**Murder.Ai** is an immersive, LLM-powered detective game where you interrogate suspects, gather evidence, and solve procedurally generated murder mysteries.
+
+---
+
+## 🎬 Demo Video
+
+[![YouTube Demo](https://img.youtube.com/vi/dQw4w9WgXcQ/0.jpg)](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
+
+---
+
+## 🚀 Socials
+
+*   [X Post](https://x.com/placeholder)
+*   [Reddit Post](https://reddit.com/r/placeholder)
+
+---
+## 🎮 How to Play
+
+### **Two Game Modes**
+1.  **Interactive Mode:** YOU are the detective. Use tools, interrogate suspects, and solve the case.
+2.  **AI Spectator Mode (Beta):** Watch an autonomous **AI Detective** play the game, reason through evidence, and make accusations in real-time.
+
+### **The Flow**
+1.  **Select a Case:** Choose from scenarios like "The Silicon Valley Incident" or "The Art Gallery Heist".
+2.  **Gather Evidence:** Use your toolkit to find clues.
+3.  **Interrogate:** Chat with suspects. They have unique personalities, secrets, and **VOICES** (powered by ElevenLabs).
+4.  **Accuse:** When you think you know the truth, make your move. But be careful—wrong accusations cost you rounds!
+
+---
+
+## 🛠️ Tech Stack & Features
+
+### **Core Architecture**
+*   **Frontend:** Custom HTML5/CSS/JS game interface embedded in **Gradio**. Uses a "Noir" theme with interactive corkboards and polaroids.
+*   **Backend:** **FastAPI** handles game state and serves the frontend. **Python** game engine manages logic.
+*   **Bridge:** A robust **API Bridge** connects the JS frontend to the Python backend for real-time interactions.
+
+### **AI & MCP Tools**
+The game is built on the **Model Context Protocol (MCP)**, allowing the AI (and you) to use tools:
+*   `get_location(phone)`: Triangulate suspect positions.
+*   `get_footage(camera)`: Watch security tapes (unlocks physical evidence).
+*   `get_dna_test(item)`: Analyze fingerprints and DNA on objects.
+*   `call_alibi(id)`: Call an alibi witness (simulated by a secondary LLM Agent).
+
+### **Voice Integration**
+*   **Text-to-Speech:** Integrated **ElevenLabs API** gives every suspect a unique voice based on their archetype (CEO, Janitor, etc.).
+*   **Voice-to-Text:** Browser-native Speech Recognition allows you to *speak* your interrogation questions.
+
+---
+
+## 📦 Installation
+
+```bash
+git clone https://github.com/yourusername/murder-ai.git
+cd murder-ai
+pip install -r requirements.txt
+```
+
+### **Environment Variables**
+Create a `.env` file:
+```env
+GEMINI_API_KEY=your_gemini_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+```
+
+### **Run**
+```bash
+python app.py
+```
+Open http://localhost:7860
+
+---
+
+**MCP-1st-Birthday Hackathon 2025**

app.py

@@ -518,7 +518,7 @@ with gr.Blocks(title="Murder.Ai", fill_height=True) as demo:
     gr.Markdown("### 🎥 How to Play (Demo)")
     gr.HTML('<iframe width="100%" height="400" src="https://www.youtube.com/embed/dQw4w9WgXcQ" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>')
         
-    gr.Markdown("# 🛠️ Try MCP Tools Directly")
+    gr.Markdown("# 🛠️ Try MCP Tools Directly (Click Open Case Files first)")
     gr.Markdown("*Note: Start a game first to populate these tools.*")
     
     with gr.Tabs():