readme added

README.md

@@ -1,3 +1,55 @@
 ---
-license: mit
+license: apache-2.0
+base_model: Qwen/Qwen2.5-0.5B-Instruct
+library_name: peft
+pipeline_tag: text-generation
+language:
+- en
+tags:
+- emergency-response
+- resqai
+- structured-json
+- lora
+- qwen2.5
+- Indian-emergency-system
 ---
+
+# Devrcb/Emergency_informed_Qwen
+
+**Emergency_informed_Qwen** is a fine-tuned LoRA adapter based on [`Qwen/Qwen2.5-0.5B-Instruct`](https://huggingface.co/Qwen/Qwen2.5-0.5B-Instruct)[cite: 2]. It is specifically trained as the **Emergency Understanding Agent** for the **ResQAI Emergency Response System**[cite: 2, 3].
+
+The model parses unstructured emergency reports (voice transcripts, text messages, citizen distress calls) and converts them into strict, structured JSON outputs for automated emergency dispatch, triage, and location routing[cite: 2, 3].
+
+---
+
+## Model Details
+
+* **Developed by:** Devrcb
+* **Model Type:** Causal Language Model (Fine-Tuned Adapter via PEFT/LoRA)
+* **Base Model:** `Qwen/Qwen2.5-0.5B-Instruct`
+* **Task:** Zero-shot / Few-shot Emergency Classification & Structured JSON Extraction
+* **Fine-Tuning Framework:** Hugging Face `trl` (SFTTrainer) & `peft`
+* **Language:** English (optimized for Indian emergency context)
+
+---
+
+## Intended Use
+
+### Primary Use Case
+This model is designed to run in real-time emergency dispatch pipelines (e.g., ResQAI)[cite: 2, 3]. Given a raw description of an emergency, it extracts:
+1. **Emergency Type & Severity Level**
+2. **Services Required** (EMS, Fire Brigade, Police)[cite: 2]
+3. **Medical Speciality Needed**[cite: 2]
+4. **Immediate Citizen First-Aid / Action Advice**[cite: 2]
+
+### Output Format
+The model is strictly trained to output **only valid JSON** adhering to the following schema[cite: 2]:
+
+```json
+{
+  "citizen_advice": ["Call emergency services immediately", "Stay clear of smoke"],
+  "emergency_type": "Fire",
+  "medical_speciality": "Emergency Medicine",
+  "services_required": ["Emergency Medical Services (EMS)", "Firefighting"],
+  "severity": "High"
+}