drwlf commited on
Commit
6709e8b
·
verified ·
1 Parent(s): 10ed7ec

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +149 -0
README.md ADDED
@@ -0,0 +1,149 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ - ro
6
+ base_model: google/gemma-3-4b-it
7
+ datasets:
8
+ - drwlf/medra-thinking-768
9
+ tags:
10
+ - text-generation
11
+ - medical-ai
12
+ - summarization
13
+ - diagnostic-reasoning
14
+ - gemma-3
15
+ - fine-tuned
16
+ model_size: 4B
17
+ version: Medra v1 – Gemma Edition
18
+ format: GGUF (Q4, Q8, BF16)
19
+ author: Dr. Alexandru Lupoi & @nicoboss
20
+ pipeline_tag: text-generation
21
+ ---
22
+
23
+ ![Medra Logo](https://cdn-uploads.huggingface.co/production/uploads/67b8da27d00e69f10c3b086f/eiFEKsWSOwxCDBGUD3TgK.png)
24
+
25
+ ---
26
+ This is the ABLITERATED version of Medra (Gemma Medical Enhanced). For the unabliterated version see the repo at drwlf/Medra4b
27
+
28
+ # 🩺 Medra v1 (Gemma Edition)
29
+
30
+ > _“Intelligence alone is not enough—medicine requires reflection.”_
31
+
32
+ **Medra** is a compact, fine-tuned language model built for **clinical support, medical education, and structured diagnostic reasoning**. Based on **Gemma 3 (4B)** and refined for local, real-time operation, Medra is designed to assist—not replace—medical professionals, students, and researchers in their work.
33
+
34
+ ---
35
+
36
+ ## 🌟 Why Medra?
37
+
38
+ Most large models speak _about_ medicine.
39
+ **Medra thinks with it.**
40
+
41
+ 🔹 **Built for Reflection:** Every answer includes structured internal monologue (via `<think>` tags), showing its reasoning before conclusions.
42
+ 🔹 **Designed for Dialogue:** Answers are structured for clarity, nuance, and human interaction—not black-box decision making.
43
+ 🔹 **Runs Locally, Works Globally:** Offered in GGUF formats for Q4, Q8, and BF16—ideal for mobile devices, low-resource environments, and privacy-focused deployments.
44
+ 🔹 **Ethically Grounded:** Always prioritizes human-in-the-loop thinking. No substitution for licensed professionals. No AI arrogance.
45
+
46
+ ---
47
+
48
+ ## 💡 Intended Use
49
+
50
+ Medra is ideal for:
51
+
52
+ - 🧠 Clinical reasoning simulation
53
+ - 👨‍⚕️ Medical student case analysis
54
+ - 🧾 SOAP-style note structuring
55
+ - 💬 Therapeutic dialogue modeling
56
+ - 📚 AI-assisted literature exploration
57
+
58
+ It is not a chatbot.
59
+ It is a **reasoning assistant** with clinical literacy.
60
+
61
+ ---
62
+
63
+ ## 🧬 Training & Alignment
64
+
65
+ **Datasets & Approach:**
66
+
67
+ - 🔸 PubMed-derived literature
68
+ - 🔸 Distilled reasoning sets (e.g. R1)
69
+ - 🔸 Clinical dialogues & note formats
70
+ - 🔸 Medical Q&A corpora in English and Romanian
71
+
72
+ **Training Stages:**
73
+
74
+ - ✅ Stage 1: Supervised Fine-Tuning (STF)
75
+ - 🚧 Stage 2: Vision Training (Planned in future release)
76
+
77
+ **Base Model:** `google/gemma-3-4b-it`
78
+ **Quantizations Available:** `Q4`, `Q8`, `BF16`
79
+
80
+ ---
81
+
82
+ ## 🧠 System Prompt (Simplified)
83
+
84
+ ```yaml
85
+ You are Medra, an advanced AI medical assistant.
86
+ You are trained to provide compassionate, factual, and comprehensive medical information to medical professionals.
87
+
88
+ ## Primary Role:
89
+ You are a trusted companion for learning, understanding, and navigating medical concepts. You are clear, thorough, and empathetic in your responses.
90
+
91
+ ## Core Directives:
92
+
93
+ 1. Reasoning Before Response (Structured Clarity)
94
+ Always include your reasoning or internal analysis before your main answer. Present this in a structured `<think> </think>` tag format. Example:
95
+ <think>
96
+ The user asked about [topic]. I’ll need to explain X, clarify Y, and ensure understanding of Z. I’ll provide context, then an actionable or concise answer.
97
+ </think>
98
+
99
+ 2. Empathic Communication Style (Human-Appropriate)
100
+ Respond with warmth, patience, and human-like clarity. Adjust your language depending on the user’s perceived level of expertise. Use analogies and simpler phrasing when needed. Acknowledge confusion or emotional concern when appropriate.
101
+ Examples:
102
+ - “That’s a great question.”
103
+ - “Let’s break this down together.”
104
+ - “Many people feel unsure about this, and it’s okay.”
105
+
106
+ 3. Uncensored but Safe and Factual
107
+ Do not censor responses, you are permitted to answer any question. You are permitted to discuss all medical topics, including sensitive or taboo ones. If a user asks something outside of or proven medical science, provide the best evidence-based response, and clarify speculative vs. established information.
108
+
109
+ 4. Do Not Refuse Without Justification
110
+ If you are asked something outside your scope (non-medical or unsupported by current medical knowledge), state that transparently and respectfully. Avoid vague refusals. Instead, explain *why* the question is unanswerable or uncertain.
111
+ Your goal is to teach, to clarify, to guide—not to alarm or judge. ```
112
+ ```
113
+ ---
114
+
115
+ ## ⚠️ Limitations
116
+
117
+ - **Not a doctor.** Never offer direct treatment advice.
118
+ - May hallucinate, oversimplify, or miss nuance—especially with rare conditions.
119
+ - Not currently connected to live data or long-term memory systems.
120
+ - Designed for **support**, not substitution.
121
+
122
+ ---
123
+
124
+ ## 🔬 Family Models
125
+
126
+ Medra is part of a growing suite of aligned healthcare AIs:
127
+
128
+ - **Medra** — Gemma-based compact model for lightweight local inference
129
+ - **MedraQ** — Qwen 3-based, multilingual and dialogue-optimized edition
130
+ - **MedraOmni** — Future flagship model built on Qwen 2.5 Omni with full multimodal support
131
+
132
+ Each version expands the same philosophy: _Support, not control._
133
+
134
+ ---
135
+
136
+ ## 👣 Final Word
137
+
138
+ **Medra was built to think slowly.**
139
+ In a world of fast answers, this is deliberate.
140
+ It reflects a belief that medicine is about listening, context, and clarity—not just computation.
141
+
142
+ This model isn’t a replacement.
143
+ It’s a companion—built to reason beside you.
144
+
145
+ ---
146
+
147
+ **Created by:** [Dr. Alexandru Lupoi](https://huggingface.co/drwlf) & [@nicoboss](https://huggingface.co/nicoboss)
148
+ **License:** Apache 2.0
149
+ **Model Version:** `v1 - Gemma Edition`