Spaces:

Agents-MCP-Hackathon
/

MedCodeMCP

Running

App Files Files Community

gpaasch commited on 6 days ago

Commit

00f30b1

1 Parent(s): 77640a8

readme is good now

Browse files

Files changed (1) hide show

README.md +98 -49

README.md CHANGED Viewed

@@ -11,94 +11,143 @@ license: apache-2.0
 short_description: an MCP Tool for Symptom-to-ICD Diagnosis Mapping.
 tags:
   - mcp-server-track
-  - MistralTeam
 ---
-A voice‑enabled medical assistant that takes patient audio complaints, engages in follow‑up questions, and returns structured ICD‑10 diagnosis suggestions via an MCP endpoint. fileciteturn2file0
 # Features
-- **Audio input & ASR**: Use Whisper to transcribe real‑time patient audio (e.g. “I’ve had a dry cough for three days”).
-- **Interactive Q&A agent**: The LLM asks targeted clarifications (“Is your cough dry or productive?”) until ready to diagnose.
-- **Multi‑backend LLM**: Switch dynamically between OpenAI GPT, Mistral (HF), or any local transformers model via env flags.
-- **ICD‑10 mapping**: Leverage LlamaIndex to vector‑retrieve the most probable ICD‑10 codes with confidence scores.
-- **MCP‑server ready**: Exposes a `/mcp` REST endpoint for seamless integration with agent frameworks.
 # Getting Started
-## Clone & Install
 ```bash
-git clone https://huggingface.co/spaces/gpaasch/Grahams_Gradio_Agents_MCP_Hackathon_2025_Submission.git
-cd Grahams_Gradio_Agents_MCP_Hackathon_2025_Submission
-python3 -m venv .venv && source .venv/bin/activate
 pip install -r requirements.txt
-```
 ## Environment Variables
-| Name                 | Description                                               | Default           |
-|----------------------|-----------------------------------------------------------|-------------------|
-| `OPENAI_API_KEY`     | OpenAI API key for GPT calls                              | none (required)   |
-| `HUGGINGFACEHUB_API_TOKEN` | HF token for Mistral/inference models                | none (required for Mistral) |
-| `USE_LOCAL_GPU`      | Set to `1` to use a local transformers model (no credits) | `0`               |
-| `LOCAL_MODEL`        | Path or HF ID of local model (e.g. `distilgpt2`)          | `gpt2`            |
-| `USE_MISTRAL`        | Set to `1` to use Mistral via HF instead of OpenAI         | `0`               |
-| `MISTRAL_MODEL`      | HF ID for Mistral model (`mistral-small/medium/large`)    | `mistral-large`   |
-| `MISTRAL_TEMPERATURE`| Sampling temperature for Mistral                          | `0.7`             |
-| `MISTRAL_MAX_INPUT`  | Max tokens for input prompt                               | `4096`            |
-| `MISTRAL_NUM_OUTPUT` | Max tokens to generate                                    | `512`             |
 ## Launch Locally
 ```bash
-# Option A: Default (OpenAI)
 python app.py
-# Option B: Mistral backend
 export USE_MISTRAL=1
 export HUGGINGFACEHUB_API_TOKEN="hf_..."
 python app.py
-# Option C: Local GPU (no credits)
 export USE_LOCAL_GPU=1
-export LOCAL_MODEL="./distilgpt2"
 python app.py
 ```
-Open http://localhost:7860 to:
-1. Record your symptoms via the **Microphone** widget.
-2. Engage in follow‑up Q&A until the agent returns a JSON diagnosis.
 ## MCP API Usage
-Send a POST to `/mcp` to call the `transcribe_and_respond` tool programmatically:
 ```bash
 curl -X POST http://localhost:7860/mcp \
   -H "Content-Type: application/json" \
-  -d '{"tool":"transcribe_and_respond","input":{"audio": "<base64_audio>", "history": []}}'
 ```
-The response will be a JSON chat history, ending with your final ICD‑10 suggestions.
-# Project Structure
 ```
-├── app.py                      # Root wrapper (HF entrypoint)
-├── src/
-│   └── app.py                  # Core Gradio & agent logic
-├── utils/
-│   └── llama_index_utils.py    # LLM predictor & indexing utils
-├── data/
-│   └── icd10cm_tabular_2025/   # ICD-10 dataset
 ├── requirements.txt            # Dependencies
 └── README.md                   # This file
 ```
-# Contributing & Support
-- Open an issue or discussion on the [Hugging Face Space](https://huggingface.co/spaces/gpaasch/Grahams_Gradio_Agents_MCP_Hackathon_2025_Submission/discussions).
-- Tag `@MistralTeam` to qualify for the \$2,000 Mistral prize.
-- Post on Discord in the **#hackathon** channel for live help.
----

 short_description: an MCP Tool for Symptom-to-ICD Diagnosis Mapping.
 tags:
   - mcp-server-track
+  - mistral
+  - llamaindex
+  - gradio
 ---
+A voice-enabled medical assistant that takes patient audio complaints, engages in follow-up questions, and returns structured ICD-10 diagnosis suggestions via an MCP endpoint.
 # Features
+- **Automatic speech recognition (ASR)**: Transcribe real-time patient audio using [Gradio](https://www.gradio.app/guides/real-time-speech-recognition).
+- **Interactive Q&A Agent**: The LLM dynamically asks clarifying questions base on ICD codes until it can diagnose with high confidence.
+- **Multi-backend LLM**: Switch between OpenAI GPT, Mistral (HF), or a local transformers model via environment flags.
+- **ICD-10 Mapping**: Use LlamaIndex for vector retrieval of probable ICD-10 codes with confidence scores.
+- **MCP-Server Ready**: Exposes a `/mcp` REST endpoint for seamless agent integration.
 # Getting Started
+## Clone & Install
 ```bash
+git clone https://huggingface.co/spaces/Agents-MCP-Hackathon/MedCodeMCP
+cd MedCodeMCP
+python3 -m venv .venv && source .venv/bin/activate
 pip install -r requirements.txt
+````
 ## Environment Variables
+| Name                       | Description                                               | Default                |
+| -------------------------- | --------------------------------------------------------- | ---------------------- |
+| `OPENAI_API_KEY`           | OpenAI API key for GPT calls                              | *required*             |
+| `HUGGINGFACEHUB_API_TOKEN` | HF token for Mistral/inference models                     | *required for Mistral* |
+| `USE_LOCAL_GPU`            | Set to `1` to use a local transformers model (no credits) | `0`                    |
+| `LOCAL_MODEL`              | Path or HF ID of local model (e.g. `distilgpt2`)          | `gpt2`                 |
+| `USE_MISTRAL`              | Set to `1` to use Mistral via HF instead of OpenAI        | `0`                    |
+| `MISTRAL_MODEL`            | HF ID for Mistral model (`mistral-small/medium/large`)    | `mistral-large`        |
+| `MISTRAL_TEMPERATURE`      | Sampling temperature for Mistral                          | `0.7`                  |
+| `MISTRAL_MAX_INPUT`        | Max tokens for input prompt                               | `4096`                 |
+| `MISTRAL_NUM_OUTPUT`       | Max tokens to generate                                    | `512`                  |
 ## Launch Locally
 ```bash
+# Default (OpenAI)
 python app.py
+# Mistral backend
 export USE_MISTRAL=1
 export HUGGINGFACEHUB_API_TOKEN="hf_..."
 python app.py
+# Local GPU (no credits)
 export USE_LOCAL_GPU=1
+export LOCAL_MODEL="./models/distilgpt2"
 python app.py
 ```
+Open [http://localhost:7860](http://localhost:7860) to interact with the app.
 ## MCP API Usage
 ```bash
 curl -X POST http://localhost:7860/mcp \
   -H "Content-Type: application/json" \
+  -d '{"tool":"transcribe_and_respond","input":{"audio":"<base64_audio>","history":[]}}'
 ```
+## Project Structure
 ```
+├── app.py                      # HF entrypoint
+├── src/app.py                  # Core Gradio & agent logic
+├── utils/llama_index_utils.py  # LLM predictor & indexing utils
+├── data/icd10cm_tabular_2025/  # ICD-10 dataset
 ├── requirements.txt            # Dependencies
 └── README.md                   # This file
 ```
+# Hackathon Timeline
+Here are the key dates for the Gradio Agents & MCP Hackathon:
+* **May 20 – 26, 2025**: Pre-Hackathon announcements period.
+* **June 2 – 10, 2025**: Official hackathon window (sign-ups remain open).
+* **June 3, 2025 — 9 AM PST / 4 PM UTC**: Live kickoff YouTube event.
+* **June 4 – 5, 2025**: Gradio Office Hours with MCP Support, MistralAI, LlamaIndex, Custom Components team, and Sambanova.
+* **June 10, 2025 — 11:59 PM UTC**: Final submission deadline.
+* **June 11 – 16, 2025**: Judging period.
+* **June 17, 2025**: Winners announced.
+# Key Players
+## Sponsors
+* **Modal Labs**: \$250 GPU/CPU credits to every participant ([modal.com](https://modal.com)).
+* **Hugging Face**: \$25 API credits to every participant ([huggingface.co](https://huggingface.co)).
+* **Nebius**: \$25 API credits to first 3,300 participants ([nebius.com](https://nebius.com)).
+* **Anthropic**: \$25 API credits to first 1,000 participants ([anthropic.com](https://www.anthropic.com)).
+* **OpenAI**: \$25 API credits to first 1,000 participants ([openai.com](https://openai.com)).
+* **Hyperbolic Labs**: \$15 API credits to first 1,000 participants ([hyperbolic.xyz](https://hyperbolic.xyz)).
+* **MistralAI**: \$25 API credits to first 500 participants ([mistral.ai](https://mistral.ai)).
+* **Sambanova.AI**: \$25 API credits to first 250 participants ([sambanova.ai](https://sambanova.ai)). ([huggingface.co](https://huggingface.co/Agents-MCP-Hackathon))
+## Panel of Judges
+Judging will be conducted by representatives from sponsor partners and the Hugging Face community team, including Modal Labs, MistralAI, LlamaIndex, Sambanova.AI, and Hugging Face. To be properly judged, ensure the project is in the [proper space](https://huggingface.co/Agents-MCP-Hackathon) on hugging face, not just in a personal space. Click join organization, then click new to create a space that will be judged.
+## Office Hours Hosts
+* **Abubakar Abid** (MCP Support) — [@abidlabs](https://huggingface.co/abidlabs)
+* **MistralAI Office Hours** — [Watch on YouTube](https://www.youtube.com/watch?v=TkyeUckXc-0)
+* **LlamaIndex Office Hours** — [Watch on YouTube](https://www.youtube.com/watch?v=Ac1sh8MTQ2w)
+* **Custom Components Office Hours** — [Watch on YouTube](https://www.youtube.com/watch?v=DHskahJ2e-c)
+* **Sambanova Office Hours** — [Watch on YouTube](https://www.youtube.com/watch?v=h82Z7qcjgnU)
+## Primary Organizers
+* **Yuvraj Sharma (Yuvi)** (@yvrjsharma) — Machine Learning Engineer & Developer Advocate, Gradio Team at Hugging Face
+* **Abubakar Abid** (@abidlabs) — Developer Advocate & MCP Support Lead at Hugging Face
+* **Gradio Team at Hugging Face** — Core organizing team providing platform infrastructure, logistics, and community coordination
+# Resources
+* **Hackathon Org & Registration**: [Agents-MCP-Hackathon](https://huggingface.co/Agents-MCP-Hackathon)
+* **Discord**: [discord.gg/agents-mcp-hackathon](https://discord.gg/agents-mcp-hackathon)
+* **Slides from Kickoff**: [PDF](https://huggingface.co/spaces/Agents-MCP-Hackathon/README/blob/main/Gradio%20x%20Agents%20x%20MCP%20Hackathon.pdf)
+* **Code of Conduct**: [Contributor Covenant](https://huggingface.co/code-of-conduct)
+* **Submission Guidelines**: See “Submission Guidelines” on the hackathon page
+* **MCP Guide**: [How to Build an MCP Server](https://huggingface.co/blog/gradio-mcp)
+* **Gradio Docs**: [https://www.gradio.app/docs](https://www.gradio.app/docs)
+* **LlamaIndex Docs**: [https://llamaindex.ai/docs](https://llamaindex.ai/docs)
+* **Mistral Model Hub**: [https://huggingface.co/mistral-ai/mistral-small](https://huggingface.co/mistral-ai/mistral-small)
+# About the Author
+**Graham Paasch** is an AI realist passionate about the coming AI revolution.
+* LinkedIn: [https://www.linkedin.com/in/grahampaasch/](https://www.linkedin.com/in/grahampaasch/)
+* YouTube: [https://www.youtube.com/channel/UCg3oUjrSYcqsL9rGk1g\_lPQ](https://www.youtube.com/channel/UCg3oUjrSYcqsL9rGk1g_lPQ)
+Graham is currently looking for work. Inspired by Leopold Aschenbrenner’s “AI Situational Awareness” ([https://situational-awareness.ai/](https://situational-awareness.ai/)), he believes AI will become a multi-trillion-dollar industry over the next decade—what we’re seeing now is the equivalent of ARPANET in the early days of the internet. He’s committed to aligning his work with this vision to stay at the forefront of the AI revolution.