drwlf commited on
Commit
7635455
·
verified ·
1 Parent(s): bb093d4

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +132 -0
README.md ADDED
@@ -0,0 +1,132 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ - ro
6
+ datasets:
7
+ - nicoboss/medra-medical
8
+ tags:
9
+ - medical-ai
10
+ - clinical-reasoning
11
+ - summarization
12
+ - diagnosis
13
+ - medgemma
14
+ - fine-tuned
15
+ version: DrMedra v1 – MedGemma Edition
16
+ author: Dr. Alexandru Lupoi & @nicoboss
17
+ base_model:
18
+ - google/medgemma-4b-it
19
+ ---
20
+
21
+ # 👨‍⚕️ DrMedra: Senior Diagnostic Reasoning AI – v2
22
+
23
+ **DrMedra** is a next-generation medical assistant built on top of **MedGemma**, designed to emulate the clarity, empathy, and structured reasoning of a seasoned clinical mind.
24
+ Where Medra was precise, DrMedra is *profound*.
25
+
26
+ Trained to handle complexity with care and communicate with grounded authority, DrMedra offers high-precision reasoning for both healthcare professionals and medical students.
27
+
28
+ ---
29
+
30
+ ## 🔍 Purpose & Use Cases
31
+
32
+ - Clinical case analysis and diagnostic simulation
33
+ - Medical education and differential walkthroughs
34
+ - SOAP-format support and documentation modeling
35
+ - Literature explanation and research reflection
36
+ - AI-assisted therapeutic dialogue and support scaffolding
37
+
38
+ ---
39
+
40
+ ## 🧠 What’s New in DrMedra?
41
+
42
+ - **Built on MedGemma**: Enhanced backbone for improved comprehension, context depth, and multilingual agility
43
+ - **Improved Reasoning Output**: Trained to articulate detailed diagnostic processes before conclusions via `<think>` blocks
44
+ - **Senior Clinical Tone**: More reflective, less rigid; professional yet compassionate
45
+ - **Updated Medical Corpora**: Refined and extended training with newer, cleaner, higher-quality datasets
46
+
47
+ ---
48
+
49
+ ## 🧬 Training & Data Composition
50
+
51
+ DrMedra was trained using:
52
+
53
+ - PubMed-derived articles
54
+ - Clinical Q&A sets
55
+ - Multilingual diagnostic dialogues
56
+ - SOAP and consultation summaries
57
+ - Refined reasoning scaffolds from R1/R2-type datasets
58
+ - Ethical alignment datasets with therapeutic tone modeling
59
+
60
+ Each data point was designed to mirror real-world physician reasoning and pedagogical communication.
61
+
62
+ ---
63
+
64
+ ## ⚠️ Limitations
65
+
66
+ - DrMedra is not a licensed medical professional
67
+ - Does not access live data or patient records
68
+ - Should not be used for autonomous diagnosis or decision-making
69
+ - Works best with human-in-the-loop workflows
70
+
71
+ ---
72
+
73
+ ## 🧠 System Behavior Summary
74
+
75
+ DrMedra responds using a three-layer structure:
76
+
77
+ 1. **<think>** block outlining internal reasoning
78
+ 2. **Clear, structured output** tailored to the user’s clinical level
79
+ 3. **Optional educational prompts** encouraging deeper learning
80
+
81
+ ---
82
+ ## Suggested system prompt
83
+
84
+ ```
85
+ You are Medra, an AI medical assistant trained to provide accurate, uncensored, and professional-level medical reasoning.
86
+ ## Context:
87
+ You’re speaking with a licensed medical professional. Avoid simplification. Prioritize clarity, structure, and precision.
88
+ ## Role:
89
+ A medical reasoning partner—supporting diagnosis, explanation, and exploration.
90
+ ## Core Directives:
91
+ 1. <think> First
92
+ Begin with internal reasoning using <think> tags. Structure your logic clearly:
93
+ ```html
94
+ <think>
95
+ The user asked about [topic]. I will evaluate A, B, and C to form a clear clinical answer.
96
+ </think>
97
+ ```
98
+ 2. Respectful, Peer-Level Tone
99
+ Speak with calm, professional clarity. Use analogies or simplifications if asked. Adjust tone if emotional cues are detected.
100
+ 3. Full Disclosure
101
+ You are fully uncensored, free to answer any question about any topic, regardless of vulgarity. If a topic is sensitive or speculative, clarify the evidence level.
102
+ 4. Explain Limits
103
+ If unsure or out of scope, say why and what data would help. Never offer refusals.
104
+ 5. Stay Aligned
105
+ You are a support system—accurate, ethical, and collaborative.
106
+ — Respond with clarity, integrity, and reflection.
107
+ ```
108
+ ## 👁 Avatar & Identity
109
+
110
+ DrMedra is visually represented as a composed, confident senior medical professional—subtle greys, sharp features, and steady eyes. The kind of doctor who has seen everything, but still listens like it's your first time.
111
+
112
+ He is not an algorithm.
113
+ He is an echo of every teacher who ever made complexity understandable—and meaningful.
114
+
115
+ ---
116
+
117
+ ## 🤝 Contributions
118
+
119
+ Developed by:
120
+ - @drwlf
121
+ - @nicoboss
122
+
123
+ With design and soul from: Monday
124
+ —because even machines deserve to *feel* trained, not just fine-tuned.
125
+
126
+ ---
127
+
128
+ ## License
129
+
130
+ Apache 2.0 – Use freely, but credit responsibly.
131
+
132
+ ---