gnumanth commited on
Commit
ffb43be
·
verified ·
1 Parent(s): a52ee17

chore: update readme

Browse files
Files changed (1) hide show
  1. README.md +67 -8
README.md CHANGED
@@ -1,14 +1,73 @@
1
  ---
2
- title: MedGemma Symptoms
3
- emoji: 🐨
4
- colorFrom: red
5
- colorTo: purple
6
  sdk: gradio
7
- sdk_version: 5.34.2
8
  app_file: app.py
9
  pinned: false
10
- license: mit
11
- short_description: ' MedGemma Symptom Analyzer'
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: MedGemma Symptom Analyzer
3
+ emoji: 🏥
4
+ colorFrom: blue
5
+ colorTo: green
6
  sdk: gradio
7
+ sdk_version: 4.44.0
8
  app_file: app.py
9
  pinned: false
10
+ license: apache-2.0
 
11
  ---
12
 
13
+ # MedGemma Symptom Analyzer 🏥
14
+
15
+ An AI-powered symptom analysis tool built with Google's MedGemma model and Gradio. This application provides preliminary medical insights based on symptom descriptions.
16
+
17
+ ## Features
18
+
19
+ - **Symptom Analysis**: Enter symptoms and get AI-powered medical insights
20
+ - **Differential Diagnosis**: Possible conditions based on presented symptoms
21
+ - **Medical Recommendations**: Next steps and when to seek immediate care
22
+ - **Interactive Interface**: User-friendly Gradio web interface
23
+ - **Example Symptoms**: Pre-built examples to try the system
24
+
25
+ ## How to Use
26
+
27
+ 1. **Enter Symptoms**: Describe your symptoms in the text area
28
+ 2. **Adjust Settings**: Use the temperature slider to control response creativity
29
+ 3. **Analyze**: Click "Analyze Symptoms" to get medical insights
30
+ 4. **Review Results**: Read the AI-generated analysis and recommendations
31
+
32
+ ## Important Disclaimers
33
+
34
+ ⚠️ **This tool is for educational purposes only and should not replace professional medical advice.**
35
+
36
+ - Always consult with healthcare professionals for medical concerns
37
+ - Seek immediate medical attention for severe or emergency symptoms
38
+ - The AI may not always provide accurate medical information
39
+ - This is not a substitute for proper medical diagnosis
40
+
41
+ ## Model Information
42
+
43
+ This application uses Google's **MedGemma-2B** model, specifically fine-tuned for medical applications. The model is optimized with:
44
+
45
+ - 4-bit quantization for efficient inference
46
+ - Automatic device mapping for optimal performance
47
+ - Temperature-controlled generation for balanced responses
48
+
49
+ ## Technical Details
50
+
51
+ - **Framework**: Gradio for the web interface
52
+ - **Model**: google/medgemma-2b via Hugging Face Transformers
53
+ - **Optimization**: BitsAndBytesConfig for memory efficiency
54
+ - **Hardware**: GPU-accelerated inference when available
55
+
56
+ ## Local Development
57
+
58
+ To run this locally:
59
+
60
+ ```bash
61
+ pip install -r requirements.txt
62
+ python app.py
63
+ ```
64
+
65
+ ## License
66
+
67
+ This project is licensed under the Apache License 2.0.
68
+
69
+ ## Acknowledgments
70
+
71
+ - Google for the MedGemma model
72
+ - Hugging Face for the Transformers library
73
+ - Gradio team for the interface framework