Update README.md

README.md

@@ -10,9 +10,62 @@ tags:
 license: cc-by-nc-sa-4.0
 ---
 
+## Model Card for BiMediX
+
+### Model Details
+- **Name:** BiMediX
+- **Version:** 1.0
+- **Type:** Bilingual Medical Mixture of Experts Large Language Model (LLM)
+- **Languages:** English, Arabic
+- **Model Architecture:** [Mixtral-8x7B-Instruct-v0.1](https://huggingface.co/mistralai/Mixtral-8x7B-Instruct-v0.1)
+- **Training Data:** BiMed1.3M, a bilingual dataset with diverse medical interactions.
+
+### Intended Use
+- **Primary Use:** Medical interactions in both English and Arabic.
+- **Capabilities:** MCQA, closed QA and chats.
+
+## Getting Started
+
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+model_id = "BiMediX/BiMediX-Bi"
+
+tokenizer = AutoTokenizer.from_pretrained(model_id)
+model = AutoModelForCausalLM.from_pretrained(model_id)
+
+text = "Hello BiMediX! I've been experiencing increased tiredness in the past week."
+inputs = tokenizer(text, return_tensors="pt")
+
+outputs = model.generate(**inputs, max_new_tokens=500)
+print(tokenizer.decode(outputs[0], skip_special_tokens=True))
+```
+
+### Training Procedure
+- **Dataset:** Semi-automated English-to-Arabic translation with human refinement.
+- **Training Resources:** 632 million healthcare specialized tokens.
+- **Evaluation:**
+
+### Model Performance
+- **Benchmarks:** Outperforms the baseline model and Jais-30B in medical evaluations.
 
 | **Model**                         | **CKG** | **CBio** | **CMed** | **MedGen** | **ProMed** | **Ana** | **MedMCQA** | **MedQA** | **PubmedQA** | **AVG** |
 |-----------------------------------|------------|-----------|-----------|-------------|-------------|---------|-------------|-----------|--------------|---------|
 | Jais-30B | 57.4       | 55.2      | 46.2      | 55.0        | 46.0        | 48.9    | 40.2        | 31.0      | 75.5         | 50.6    |
 | Mixtral-8x7B| 59.1       | 57.6      | 52.6      | 59.5        | 53.3        | 54.4    | 43.2        | 40.6      | 74.7         | 55.0    |
-| **BiMediX (Bilingual)**           | **70.6**   | **72.2**  | **59.3**  | **74.0**    | **64.2**    | **59.6**| **55.8**    | **54.0**  | **78.6**     | **65.4**|
+| **BiMediX (Bilingual)**           | **70.6**   | **72.2**  | **59.3**  | **74.0**    | **64.2**    | **59.6**| **55.8**    | **54.0**  | **78.6**     | **65.4**|
+
+### Limitations
+- Potential issues: hallucinations, toxicity, stereotypes.
+- Medical diagnoses and recommendations require human evaluation.
+
+### Safety and Ethical Considerations
+- **Usage:** Research purposes only.
+
+
+### Accessibility
+- **Availability:** [BiMediX GitHub Repository](https://github.com/mbzuai-oryx/BiMediX).
+
+### Authors
+Sara Pieri, Sahal Shaji Mullappilly, Fahad Shahbaz Khan, Rao Muhammad Anwer Salman Khan, Timothy Baldwin, Hisham Cholakkal, Mohamed Bin Zayed University of Artificial Intelligence (MBZUAI).
+