Update README.md

README.md

@@ -43,42 +43,82 @@ The model incorporates comprehensive stylometric analysis including:
 - **Author Tokens:** Descriptive tokens like `<author:يوسف_إدريس>`
 - **Target:** Generated text in author's style
 
-## 🎯 Model Performance
+## 📚 Supported Authors
+
+<p align="center">
+  <img src="https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/qDHUSa6ZvD1LjN9uJs-jp.png" width="600"/>
+</p>
+
+
+## 📁 Input File Format
+
+For batch processing, your input file should have the following format:
+
+## 📊 Example Snippets from the Dataset
+
+| id | text_in_msa (partial) | text_in_author_style (partial) |
+|----|------------------------|--------------------------------|
+| 3835 | "لم أقم مطلقًا بالاحتفال بعيد ميلادي... وكنت أتجادل مع كامل الشناوي..." | "عمري ما احتفلت بعيد ميلادي... وأتشاجر مع كامل الشناوي على ذلك الاكتئاب..." |
+| 3836 | "الزمن العام هو العداد الجماعي الذي يسجل السنين... ويبرز الزمن الخاص..." | "الزمن العام يعدّ السنين للناس كلها... أما عدادك الخاص فأنت نادرًا ما تنظر فيه..." |
+| 3837 | "مصر الغنية الراقية... اشتراكية وديمقراطية تتفاعل معًا... أحلام الخمسين..." | "مصر المصنِّعة... الكون مائة زهرة... وحين أبلغ الخمسين أبدأ أعيش وأتعلم الموسيقى..." |
+| 3838 | "غرابة التجربة... طفولة جادة تمامًا بلا مرح... الطفولة كانت عيبًا..." | "غريبة هي الأفكار... كنتُ رجلًا رهيبًا في ثوب طفل... والطفولة تُهمة نخشى الاعتراف بها..." |
+| 3839 | "هذا ليس ندمًا... موجة تفوقك قوة... النصر الحقيقي أن تعيش كما تختار..." | "ليس مرارة ولا ندمًا... أنت تناضل موجة أعتى منك... والحق أن تحيا كما اخترت أنت..." |
+
+
+## 📊 Performance Metrics
 
 - **BLEU Score:** 24.58
 - **chrF Score:** 59.01
 - **Competition:** First Place in AraGenEval 2024
 - **Supported Authors:** 21 Arabic authors
 
-## 📚 Supported Authors
+Official results on the AraGenEval 2025 testset. Our prompt engineering system ranked first.
 
-<p align="center">
-  <img src="https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/qDHUSa6ZvD1LjN9uJs-jp.png" width="600"/>
+<p align="left">
+  <img src="https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/pCfAK4zefvXZ4YI1AvXIG.png" width="400"/>
 </p>
 
+## 🚀 Quick Start: Style Transfer Example
 
-## 📁 Input File Format
+```python
+from transformers import T5Tokenizer, T5ForConditionalGeneration
+import torch
 
-For batch processing, your input file should have the following format:
+# Load model
+model_name = "Omartificial-Intelligence-Space/AraStyleTransfer-21"
 
-### CSV Format
-```csv
-text,author
+tokenizer = T5Tokenizer.from_pretrained(model_name)
+model = T5ForConditionalGeneration.from_pretrained(model_name)
 
+device = "cuda" if torch.cuda.is_available() else "cpu"
+model.to(device)
 
+# Input text and author
+text = "لم أقم مطلقًا بالاحتفال بعيد ميلادي منذ طفولتي."
+author = "يوسف إدريس"
 
+# Prompt format
+prompt = f"اكتب النص التالي بأسلوب <author:{author.replace(' ', '_')}>: {text}"
 
-```
+# Tokenize
+inputs = tokenizer(prompt, return_tensors="pt").to(device)
 
-### Excel Format
-Same structure as CSV but in Excel format.
+# Generate
+output_ids = model.generate(
+    **inputs,
+    max_length=256,
+    num_beams=5,
+    early_stopping=True
+)
 
-## 📊 Performance Metrics
+# Decode
+generated_text = tokenizer.decode(output_ids[0], skip_special_tokens=True)
+
+print("Original:", text)
+print("Author:", author)
+print("Output:", generated_text)
+```
 
-| Metric | Score |
-|--------|-------|
-| BLEU   | 24.58 |
-| chrF   | 59.01 |
 
 ## 🎯 Use Cases
 
@@ -89,23 +129,12 @@ Same structure as CSV but in Excel format.
 
 ## 🤝 Contributing
 
-This model was developed for the AraGenEval 2025 competition. For questions or contributions, please refer to the competition guidelines.
+This model was developed for the [AraGenEval 2025](https://ezzini.github.io/AraGenEval/) competition. For questions or contributions, please refer to the competition guidelines.
 
 ## 📄 License
 
 This model is released under the same license as the base AraT5v2 model.
 
-## 🙏 Acknowledgments
-
-- **Competition:** AraGenEval 2025
-- **Base Model:** UBC-NLP/AraT5v2-base-1024
-- **Dataset:** Arabic Authorship Style Transfer Task 1
-- **Results:** First Place Winner
-
-## 📞 Contact
-
-For questions about the model or usage, please refer to the competition documentation or model repository.
-
 
 ## BibTeX Citation