---
license: apache-2.0
language:
- fa
- en
tags:
- persian
- llm
- text-generation
- pytorch
- transformers
- gpt
- conversational
- persian-nlp
- iran
library_name: transformers
pipeline_tag: text-generation
datasets:
- ysn-rfd/Fibonacci-Pre_Train-Persian-Corpus-Raw-Texts-Dataset
model-index:
- name: Yasin-Model
  results: []
metrics:
- accuracy
- perplexity
---

<div align="center">

# 🤖 مدل زبانی ایران نسخه ۱ با معماری بومی یاسین 🇮🇷

### 🌟 اولین معماری مدل زبانی متن‌باز فارسی

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&height=200&section=header&text=مدل%20زبانی%20ایران&fontSize=45&fontColor=FFFFFF&desc=پلی%20میان%20پیشرفته‌ترین%20پژوهش‌های%20دنیا%20و%20زبان%20شیرین%20فارسی&descSize=16&descAlignY=70&animation=fadeIn&color=0:1E7A34,50:FFFFFF,100:DC2626" width="100%"/>
</p>

<p align="center">
  <a href="https://huggingface.co/fibonacciai/">
    <img src="https://img.shields.io/badge/🤗%20Hugging%20Face-مدل%20ایران-8B5CF6?style=for-the-badge&logo=huggingface" alt="Hugging Face"/>
  </a>
  <a href="https://www.python.org/">
    <img src="https://img.shields.io/badge/Python-3.8%2B-3776AB?style=for-the-badge&logo=python" alt="Python"/>
  </a>
  <a href="https://pytorch.org/">
    <img src="https://img.shields.io/badge/PyTorch-2.0%2B-EE4C2C?style=for-the-badge&logo=pytorch" alt="PyTorch"/>
  </a>
  <a href="https://opensource.org/licenses/Apache-2.0">
    <img src="https://img.shields.io/badge/License-Apache%202.0-7D3C98?style=for-the-badge" alt="License"/>
  </a>
</p>

<p align="center">
  <a href="https://github.com/realrobotteam">
    <img src="https://img.shields.io/github/stars/realrobotteam/yasin-model?style=for-the-badge&logo=github&color=yellow" alt="GitHub Stars"/>
  </a>
  <a href="https://colab.research.google.com/">
    <img src="https://img.shields.io/badge/Colab-دموی%20آنلاین-F9AB00?style=for-the-badge&logo=googlecolab" alt="Colab"/>
  </a>
</p>

</div>

---

## 📋 فهرست مطالب

<table align="center" style="width: 100%; border: none;">
<tr>
<td align="center" width="25%"><a href="#-معرفی-کلی">🌟 معرفی</a></td>
<td align="center" width="25%"><a href="#-ویژگی‌های-منحصربه‌فرد">✨ ویژگی‌ها</a></td>
<td align="center" width="25%"><a href="#-نمونه-خروجی-واقعی">📊 نمونه خروجی</a></td>
<td align="center" width="25%"><a href="#️-معماری-فنی-پیشرفته">⚙️ معماری</a></td>
</tr>
<tr>
<td align="center"><a href="#-شروع-سریع">🚀 شروع سریع</a></td>
<td align="center"><a href="#-نتایج-آموزش-و-ارزیابی">📈 نتایج</a></td>
<td align="center"><a href="#-آموزش-و-فاینتیون">🎓 آموزش</a></td>
<td align="center"><a href="#-مجوز-و-شرایط-استفاده">📜 مجوز</a></td>
</tr>
</table>

---

## 🌟 معرفی کلی

<div align="center">

<table style="width: 100%; border: none; background: linear-gradient(145deg, #1a2639, #2c3e50); border-radius: 25px; padding: 30px; box-shadow: 0 20px 40px rgba(139,92,246,0.15); border-bottom: 6px solid #8B5CF6;">
<tr>
<td style="padding: 25px; color: white;">

<h2 align="center">🎯 مدل زبانی ایران چیست؟</h2>

<p align="justify" style="font-size: 17px; line-height: 2; color: #f1f5f9;">
<strong style="color: #a78bfa;">ایران نسخه ۱</strong> یک مدل زبانی بزرگ (LLM) دوزبانه فارسی-انگلیسی است که با معماری <strong style="color: #a78bfa;">ترنسفورمر پیشرفته</strong> و تکنیک‌های مدرن <code style="background: rgba(139,92,246,0.2); padding: 2px 8px; border-radius: 5px;">GQA</code>، <code style="background: rgba(139,92,246,0.2); padding: 2px 8px; border-radius: 5px;">RoPE</code> و <code style="background: rgba(139,92,246,0.2); padding: 2px 8px; border-radius: 5px;">SwiGLU</code> پیاده‌سازی شده است. این مدل حاصل آموزش روی <strong style="color: #fbbf24;">۳۰ میلیون</strong> متن فارسی و استفاده از آخرین دستاوردهای پژوهشی در حوزه پردازش زبان طبیعی است.
</p>

<p align="justify" style="font-size: 17px; line-height: 2; color: #f1f5f9;">
<strong style="color: #fbbf24;">ایران نسخه ۱</strong> برای این ساخته شده که زبان فارسی را در دنیای هوش مصنوعی زنده نگه دارد. برخلاف مدل‌های عمومی که فارسی را به‌عنوان زبان دوم می‌بینند، یاسین از ابتدا برای درک عمق ادبیات، فرهنگ و ساختار منحصربه‌فرد زبان فارسی طراحی شده است.
</p>

</td>
</tr>
</table>

</div>

---

## ✨ ویژگی‌های منحصربه‌فرد

<div align="center">

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 20px;">
<tr>
<td style="width: 50%; vertical-align: top;">

<div style="background: linear-gradient(135deg, #f5f3ff, #ede9fe); padding: 30px; border-radius: 25px; border-bottom: 6px solid #8B5CF6; box-shadow: 0 15px 35px rgba(139,92,246,0.12); height: 100%;">

<div align="center">
<img src="https://img.shields.io/badge/🎯-8B5CF6?style=for-the-badge&logoSize=40" alt="icon" style="width: 80px; height: 80px; border-radius: 50%; background: #8B5CF6;"/>
</div>

<h3 align="center" style="color: #5b21b6; font-size: 22px;">معماری یاسین با بومی‌سازی عمیق</h3>

<p align="justify" style="font-size: 15px; line-height: 1.8; color: #4c1d95;">
• طراحی شده از پایه برای زبان فارسی<br/>
• درک اصطلاحات، ضرب‌المثل‌ها و ساختارهای دستوری پیچیده<br/>
• پشتیبانی کامل از خط و نگارش فارسی
</p>

</div>

</td>
<td style="width: 50%; vertical-align: top;">

<div style="background: linear-gradient(135deg, #eff6ff, #dbeafe); padding: 30px; border-radius: 25px; border-bottom: 6px solid #3B82F6; box-shadow: 0 15px 35px rgba(59,130,246,0.12); height: 100%;">

<div align="center">
<img src="https://img.shields.io/badge/⚡-3B82F6?style=for-the-badge&logoSize=40" alt="icon" style="width: 80px; height: 80px; border-radius: 50%; background: #3B82F6;"/>
</div>

<h3 align="center" style="color: #1e40af; font-size: 22px;">کارایی فوق‌العاده</h3>

<p align="justify" style="font-size: 15px; line-height: 1.8; color: #1e3a8a;">
• مکانیزم GQA با کاهش <strong>۷۵٪</strong> مصرف حافظه<br/>
• پشتیبانی از Flash Attention 2<br/>
• استنتاج سریع‌تر با SDPA
</p>

</div>

</td>
</tr>
<tr>
<td style="width: 50%; vertical-align: top;">

<div style="background: linear-gradient(135deg, #ecfdf5, #d1fae5); padding: 30px; border-radius: 25px; border-bottom: 6px solid #10B981; box-shadow: 0 15px 35px rgba(16,185,129,0.12); height: 100%;">

<div align="center">
<img src="https://img.shields.io/badge/🔄-10B981?style=for-the-badge&logoSize=40" alt="icon" style="width: 80px; height: 80px; border-radius: 50%; background: #10B981;"/>
</div>

<h3 align="center" style="color: #065f46; font-size: 22px;">انعطاف‌پذیری کامل</h3>

<p align="justify" style="font-size: 15px; line-height: 1.8; color: #064e3b;">
• قابل اجرا روی GPUهای ۴GB تا ۲۴GB<br/>
• پشتیبانی از quantization 8-bit و 4-bit<br/>
• مقیاس‌پذیری پویا
</p>

</div>

</td>
<td style="width: 50%; vertical-align: top;">

<div style="background: linear-gradient(135deg, #fef3c7, #fde68a); padding: 30px; border-radius: 25px; border-bottom: 6px solid #F59E0B; box-shadow: 0 15px 35px rgba(245,158,11,0.12); height: 100%;">

<div align="center">
<img src="https://img.shields.io/badge/🌍-F59E0B?style=for-the-badge&logoSize=40" alt="icon" style="width: 80px; height: 80px; border-radius: 50%; background: #F59E0B;"/>
</div>

<h3 align="center" style="color: #92400e; font-size: 22px;">دوزبانه هوشمند</h3>

<p align="justify" style="font-size: 15px; line-height: 1.8; color: #78350f;">
• تسلط کامل به فارسی و انگلیسی<br/>
• ترجمه خودکار بین دو زبان<br/>
• درک مفاهیم بینافرهنگی
</p>

</div>

</td>
</tr>
</table>

</div>

---

## 💎 کاربردهای عملی

<div align="center">

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 15px;">
<tr>
<td align="center" width="33%">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">✍️</div>
<h3 style="color: #1e293b;">نویسندگی خلاق</h3>
<p style="color: #475569; font-size: 14px;">کمک به نوشتن مقاله، داستان، شعر و محتوای خلاقانه</p>

</div>

</td>
<td align="center" width="33%">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">📚</div>
<h3 style="color: #1e293b;">آموزش و پژوهش</h3>
<p style="color: #475569; font-size: 14px;">دستیار آموزشی هوشمند، پاسخگویی به سوالات درسی</p>

</div>

</td>
<td align="center" width="33%">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">💬</div>
<h3 style="color: #1e293b;">چت‌بات و پشتیبانی</h3>
<p style="color: #475569; font-size: 14px;">ایجاد دستیارهای هوشمند فارسی، پشتیبانی مشتری</p>

</div>

</td>
</tr>
<tr>
<td align="center">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">📊</div>
<h3 style="color: #1e293b;">تحلیل داده‌های متنی</h3>
<p style="color: #475569; font-size: 14px;">تحلیل نظرات، بررسی احساسات، دسته‌بندی متون</p>

</div>

</td>
<td align="center">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">🏥</div>
<h3 style="color: #1e293b;">سلامت و پزشکی</h3>
<p style="color: #475569; font-size: 14px;">تحلیل بازخورد بیماران، دستیار پرسش و پاسخ پزشکی</p>

</div>

</td>
<td align="center">

<div style="background: white; padding: 25px; border-radius: 20px; box-shadow: 0 10px 30px rgba(0,0,0,0.06); border: 1px solid #eaeef2; height: 100%;">

<div style="font-size: 42px; margin-bottom: 10px;">🎨</div>
<h3 style="color: #1e293b;">خلاقیت و سرگرمی</h3>
<p style="color: #475569; font-size: 14px;">تولید پادکست، شاعر الکترونیک، داستان‌پردازی</p>

</div>

</td>
</tr>
</table>

</div>

---

## 📊 نمونه خروجی واقعی

<div align="center">

<table style="width: 100%; border: none; background: linear-gradient(145deg, #0b1120, #1a1f2e); border-radius: 25px; box-shadow: 0 25px 50px rgba(0,0,0,0.2); border-right: 8px solid #8B5CF6;">
<tr>
<td style="padding: 30px;">

<h3 style="color: #a78bfa; font-size: 22px;">🔹 ورودی:</h3>

<div style="background: #1e2436; padding: 20px; border-radius: 15px; margin: 15px 0; border: 1px solid #3d4459; direction: rtl; text-align: right;">

```
هوش مصنوعی در ایران چه جایگاهی دارد؟ لطفاً با ذکر مثال توضیح دهید.
```

</div>

<h3 style="color: #a78bfa; font-size: 22px; margin-top: 30px;">🔸 خروجی مدل یاسین:</h3>

<div style="background: #1e2436; padding: 25px; border-radius: 15px; margin: 15px 0; border: 1px solid #8B5CF6; direction: rtl; text-align: right; font-family: Vazir, IRANSans, Tahoma, sans-serif;">

```
هوش مصنوعی در ایران طی سال‌های اخیر رشد قابل توجهی داشته است. دانشگاه‌های برتر 
مانند صنعتی شریف، تهران و امیرکبیر دوره‌های تخصصی در این حوزه راه‌اندازی 
کرده‌اند.

برای مثال:
✅ دانشگاه صنعتی شریف - آزمایشگاه پردازش زبان طبیعی با تمرکز بر فارسی
✅ دانشگاه تهران - مرکز تحقیقات هوش مصنوعی و رباتیک
✅ دانشگاه امیرکبیر - پژوهشکده فناوری اطلاعات و هوش مصنوعی

شرکت‌های دانش‌بنیان متعددی در زمینه پردازش زبان فارسی، بینایی ماشین و 
رباتیک فعالیت می‌کنند. شرکت‌هایی مانند هوشا، دیجیکالا و اسنپ تیم‌های 
تخصصی هوش مصنوعی دارند.

با این حال، چالش‌هایی مانند:
⚠️ دسترسی محدود به سخت‌افزارهای پیشرفته
⚠️ مهاجرت نخبگان
⚠️ کمبود داده‌های باکیفیت فارسی
⚠️ تحریم‌های بین‌المللی

وجود دارد. پیش‌بینی می‌شود با سرمایه‌گذاری بیشتر در این حوزه، ایران بتواند 
جایگاه بهتری در منطقه کسب کند.
```

</div>

</td>
</tr>
</table>

</div>

---

## ⚙️ معماری فنی پیشرفته

<div align="center" style="background: white; padding: 35px; border-radius: 30px; box-shadow: 0 20px 40px rgba(0,0,0,0.05); margin: 40px 0;">

<h3 style="font-size: 28px; color: #1e293b; border-bottom: 4px solid #8B5CF6; padding-bottom: 15px;">🧠 نمای کلی معماری</h3>

<div align="center" style="margin: 30px 0; font-family: monospace; background: #f8fafc; padding: 25px; border-radius: 20px;">

```
┌─────────────────────────────────────────────────────────────────┐
│                    📝 ورودی متنی (Text Input)                    │
└────────────────────────────────────┬────────────────────────────┘
                                     ▼
┌─────────────────────────────────────────────────────────────────┐
│                    ⚡ Embedding + RoPE                           │
│              جاسازی توکن + موقعیت‌یابی چرخشی                      │
│                 (Rotary Position Embedding)                      │
└────────────────────────────────────┬────────────────────────────┘
                                     ▼
┌─────────────────────────────────────────────────────────────────┐
│                      🔷 ×۳۲ لایه دیکودر                          │
│                       32 Decoder Layers                          │
├─────────────────────────────────────────────────────────────────┤
│  ┌───────────────────────────────────────────────────────────┐  │
│  │     🎯 Self-Attention (GQA با ۸ سر KV)                    │  │
│  │         Grouped Query Attention (4:1 ratio)               │  │
│  │           • کاهش ۷۵٪ مصرف حافظه                           │  │
│  │           • حفظ کیفیت با اشتراک‌گذاری KV                   │  │
│  └───────────────────────────────────────────────────────────┘  │
│                              ↓                                   │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │              🧮 Feed-Forward (SwiGLU)                     │  │
│  │              • تابع فعال‌سازی SiLU/Swish                   │  │
│  │              • بهبود ۲۰٪ در کیفیت خروجی                   │  │
│  │              • ۳ لایه خطی با گیتینگ هوشمند                │  │
│  └───────────────────────────────────────────────────────────┘  │
│                              ↓                                   │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │         📊 RMSNorm & Residual Connection                  │  │
│  │               • نرمال‌سازی پایدار                         │  │
│  │          • اتصال باقیمانده برای گرادیان بهتر              │  │
│  └───────────────────────────────────────────────────────────┘  │
└────────────────────────────────────┬────────────────────────────┘
                                     ▼
┌─────────────────────────────────────────────────────────────────┐
│                       🎯 LM Head                                 │
│                      خروجی نهایی                                 │
└────────────────────────────────────┬────────────────────────────┘
                                     ▼
┌─────────────────────────────────────────────────────────────────┐
│                   📄 خروجی متنی (Text Output)                    │
└─────────────────────────────────────────────────────────────────┘
```

</div>

</div>

---

### 📐 مشخصات کامل پیکربندی

<div align="center">

| دسته‌بندی | پارامتر | مقدار پیش‌فرض | توضیح فنی |
|:--------:|:------:|:-------------:|:---------:|
| 🏗️ مدل | معماری | Decoder-Only Transformer | مدل تولید متن خودرگرسیو |
| 🏗️ مدل | vocab_size | ۳۲,۰۰۰ | اندازه واژه‌نامه (شامل ۸۰۰۰ توکن فارسی) |
| 🏗️ مدل | hidden_size | ۴,۰۹۶ | ابعاد نمایش پنهان |
| 🏗️ مدل | num_hidden_layers | ۳۲ | عمق شبکه (تعداد لایه‌ها) |
| 🎯 توجه | num_attention_heads | ۳۲ | تعداد سرهای Query |
| 🎯 توجه | num_key_value_heads | ۸ | سرهای KV (نسبت GQA 4:1) |
| 🎯 توجه | attention_bias | False | بدون بایاس (بهینه‌تر) |
| 🧮 MLP | intermediate_size | ۱۱,۰۰۸ | ابعاد لایه میانی |
| 🧮 MLP | hidden_act | silu | تابع فعال‌سازی Swish (SiLU) |
| 📍 موقعیت | max_position_embeddings | ۲,۰۴۸ | حداکثر طول توالی |
| 📍 موقعیت | rope_theta | ۱۰,۰۰۰.۰ | پایه فرکانس RoPE |
| 📍 موقعیت | rope_scaling | پویا (dynamic) | مقیاس‌دهی تطبیقی تا ۸ برابر |
| 📊 نرمال‌سازی | rms_norm_eps | 1e-6 | اپسیلون RMSNorm |

</div>

---

### 🔬 نوآوری‌های پیاده‌سازی

<div align="center">

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 20px;">
<tr>
<td align="center" width="33%">

<div style="background: linear-gradient(145deg, #8B5CF6, #7C3AED); padding: 30px; border-radius: 25px; color: white; height: 100%;">
<h3 style="color: white; font-size: 24px; margin-top: 0;">🎯 GQA</h3>
<div style="font-size: 52px; margin: 15px 0; font-weight: bold;">۴:۱</div>
<p style="font-size: 18px;">کاهش ۷۵٪ مصرف حافظه</p>
<hr style="border: 1px solid rgba(255,255,255,0.3); margin: 20px 0;">
<p style="margin: 0; opacity: 0.9; font-size: 14px;">۳۲ سر Query • ۸ سر KV<br/>اشتراک‌گذاری هوشمند</p>
</div>

</td>
<td align="center" width="33%">

<div style="background: linear-gradient(145deg, #3B82F6, #2563EB); padding: 30px; border-radius: 25px; color: white; height: 100%;">
<h3 style="color: white; font-size: 24px; margin-top: 0;">🔄 RoPE</h3>
<div style="font-size: 52px; margin: 15px 0; font-weight: bold;">۸x</div>
<p style="font-size: 18px;">افزایش طول توالی</p>
<hr style="border: 1px solid rgba(255,255,255,0.3); margin: 20px 0;">
<p style="margin: 0; opacity: 0.9; font-size: 14px;">مقیاس‌دهی پویا<br/>پنجره زمینه ۱۶۳۸۴ توکنی</p>
</div>

</td>
<td align="center" width="33%">

<div style="background: linear-gradient(145deg, #10B981, #059669); padding: 30px; border-radius: 25px; color: white; height: 100%;">
<h3 style="color: white; font-size: 24px; margin-top: 0;">🧠 SwiGLU</h3>
<div style="font-size: 52px; margin: 15px 0; font-weight: bold;">۲۰٪</div>
<p style="font-size: 18px;">بهبود کیفیت خروجی</p>
<hr style="border: 1px solid rgba(255,255,255,0.3); margin: 20px 0;">
<p style="margin: 0; opacity: 0.9; font-size: 14px;">SiLU • گیتینگ دوگانه<br/>همگرایی سریع‌تر</p>
</div>

</td>
</tr>
</table>

</div>

---

## 💻 شروع سریع (فقط ۳ خط کد)

<div align="center" style="background: #0b1120; padding: 35px; border-radius: 30px; color: white;">

<h3 style="color: white; font-size: 26px; margin-top: 0;">🚀 نصب و اجرای فوری</h3>

```python
# گام ۱: نصب کتابخانه
# pip install transformers torch accelerate

from transformers import AutoModelForCausalLM, AutoTokenizer

# گام ۲: بارگذاری مدل (فقط ۳ خط!)
model_name = "your-username/yasin-model"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(model_name)

# گام ۳: استفاده از مدل
prompt = "داستان کوتاهی در مورد بهار بنویس"
inputs = tokenizer(prompt, return_tensors="pt")
outputs = model.generate(
    **inputs,
    max_length=300,
    temperature=0.7,
    do_sample=True,
    top_p=0.9
)
print(tokenizer.decode(outputs[0], skip_special_tokens=True))
```

<div style="background: #2d3748; padding: 20px; border-radius: 16px; margin-top: 20px; border-right: 6px solid #8B5CF6;">
<p style="margin: 0; font-size: 16px;"><strong>📌 نکته:</strong> برای اولین بار، مدل به صورت خودکار دانلود می‌شود (~۱۵ گیگابایت). دفعات بعدی از کش استفاده می‌کند.</p>
</div>

</div>

---

## 🛠️ پیکربندی برای سخت‌افزارهای مختلف

<div align="center">

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 25px;">
<tr>
<td width="50%" style="vertical-align: top;">

<div style="background: linear-gradient(145deg, #1a1e2c, #2d3748); padding: 30px; border-radius: 28px; color: white; border-bottom: 8px solid #3B82F6;">

<h3 align="center" style="color: white; font-size: 22px; margin-top: 0;">📦 GPU 4GB (کم‌مصرف)</h3>

```python
from configuration_yasin import YasinConfig

config = YasinConfig(
    # کاهش ابعاد اصلی
    hidden_size=512,
    num_hidden_layers=12,
    num_attention_heads=8,
    num_key_value_heads=2,  # GQA فعال
    intermediate_size=1408,
    
    # تنظیمات توالی
    max_position_embeddings=1024,
    
    # بهینه‌سازی حافظه
    use_cache=True,
    _attn_implementation="sdpa",
)

model = YasinForCausalLM(config)
```

<ul style="margin-top: 20px; list-style: none; padding-right: 0; font-size: 14px;">
<li style="margin-bottom: 10px;">✅ <strong>مصرف RAM:</strong> ~۳.۵ گیگابایت</li>
<li style="margin-bottom: 10px;">✅ <strong>سرعت:</strong> ۴۰-۵۰ توکن/ثانیه</li>
<li style="margin-bottom: 10px;">✅ <strong>مناسب:</strong> لپ‌تاپ، GPUهای خانگی</li>
</ul>

</div>

</td>
<td width="50%" style="vertical-align: top;">

<div style="background: linear-gradient(145deg, #1a1e2c, #2d3748); padding: 30px; border-radius: 28px; color: white; border-bottom: 8px solid #8B5CF6;">

<h3 align="center" style="color: white; font-size: 22px; margin-top: 0;">🚀 GPU 24GB+ (حداکثر کیفیت)</h3>

```python
config = YasinConfig(
    # ابعاد کامل
    hidden_size=4096,
    num_hidden_layers=40,
    num_attention_heads=32,
    num_key_value_heads=8,
    intermediate_size=11008,
    
    # توالی طولانی
    max_position_embeddings=8192,
    rope_theta=500000.0,
    rope_scaling={"rope_type": "dynamic", "factor": 4.0},
    
    # حداکثر سرعت
    _attn_implementation="flash_attention_2",
    use_cache=True,
)
```

<ul style="margin-top: 20px; list-style: none; padding-right: 0; font-size: 14px;">
<li style="margin-bottom: 10px;">🔥 <strong>مصرف RAM:</strong> ~۲۰ گیگابایت</li>
<li style="margin-bottom: 10px;">🔥 <strong>سرعت:</strong> ۸۰-۱۰۰ توکن/ثانیه</li>
<li style="margin-bottom: 10px;">🔥 <strong>مناسب:</strong> سرورها، A100، H100</li>
</ul>

</div>

</td>
</tr>
</table>

</div>

---

### ⚡ بهینه‌سازی بیشتر

<div align="center">

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 20px;">
<tr>
<td width="33%">

<div style="background: #f8fafc; padding: 25px; border-radius: 20px; border: 1px solid #e2e8f0;">

<h4 align="center">💾 8-bit Quantization</h4>

```python
model = AutoModelForCausalLM.from_pretrained(
    model_name,
    load_in_8bit=True,
    device_map="auto"
)
```

<p align="center" style="color: #059669; margin-top: 15px; font-weight: bold;">✓ کاهش ۵۰٪ حافظه</p>

</div>

</td>
<td width="33%">

<div style="background: #f8fafc; padding: 25px; border-radius: 20px; border: 1px solid #e2e8f0;">

<h4 align="center">🔄 4-bit Quantization</h4>

```python
model = AutoModelForCausalLM.from_pretrained(
    model_name,
    load_in_4bit=True,
    bnb_4bit_compute_dtype=torch.float16
)
```

<p align="center" style="color: #059669; margin-top: 15px; font-weight: bold;">✓ کاهش ۷۵٪ حافظه</p>

</div>

</td>
<td width="33%">

<div style="background: #f8fafc; padding: 25px; border-radius: 20px; border: 1px solid #e2e8f0;">

<h4 align="center">🧠 Gradient Checkpointing</h4>

```python
# برای آموزش با حافظه محدود
model.gradient_checkpointing_enable()
model.config.use_cache = False
```

<p align="center" style="color: #059669; margin-top: 15px; font-weight: bold;">✓ کاهش ۴۰٪ حافظه</p>

</div>

</td>
</tr>
</table>

</div>

---

## 📈 نتایج آموزش و ارزیابی

<div align="center" style="background: white; padding: 35px; border-radius: 30px; box-shadow: 0 20px 40px rgba(0,0,0,0.05);">

<h3 style="font-size: 28px; color: #1e293b; margin-top: 0;">📉 روند کاهش Loss</h3>

| گام | Training Loss | Perplexity | کاهش نسبی | زمان آموزش |
|:---:|:-------------:|:----------:|:---------:|:----------:|
| ۱۰۰ | ۴.۸۷۱۶ | ۱۳۰.۵ | پایه | ۲ دقیقه |
| ۵۰۰ | ۱.۸۱۲۶ | ۶.۱۱ | ۶۲.۸٪ | ۱۰ دقیقه |
| ۱۰۰۰ | ۱.۶۰۱۸ | ۴.۹۵ | ۶۷.۱٪ | ۲۰ دقیقه |
| ۲۰۰۰ | ۱.۵۱۴۵ | ۴.۵۳ | ۶۸.۹٪ | ۴۰ دقیقه |
| ۳۰۰۰ | ۱.۴۰۱۱ | ۴.۰۶ | ۷۱.۲٪ | ۶۰ دقیقه |
| ۴۰۰۰ | ۱.۲۸۹۶ | ۳.۶۳ | ۷۳.۵٪ | ۸۰ دقیقه |
| ۵۰۰۰ | ۱.۲۸۹۶ | ۳.۶۳ | ۷۳.۵٪ | ۱۰۰ دقیقه |

<div style="background: linear-gradient(90deg, #8B5CF6, #3B82F6); padding: 30px; border-radius: 20px; margin-top: 30px; color: white;">

<h4 align="center" style="color: white; font-size: 22px; margin-top: 0;">🏆 مقایسه با سایر مدل‌ها</h4>

<table style="width: 100%; border: none; color: white;">
<tr>
<td align="center" width="25%">
<div style="font-size: 36px; margin-bottom: 10px;">📊</div>
<div style="font-weight: bold;">Perplexity</div>
<div style="font-size: 28px; margin-top: 10px; font-weight: bold;">۳.۶۳</div>
<div style="font-size: 14px; opacity: 0.9;">یاسین</div>
<hr style="border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 20px;">۴.۸۱</div>
<div style="font-size: 14px; opacity: 0.9;">سایر مدل‌ها</div>
</td>
<td align="center" width="25%">
<div style="font-size: 36px; margin-bottom: 10px;">⚡</div>
<div style="font-weight: bold;">سرعت استنتاج</div>
<div style="font-size: 28px; margin-top: 10px; font-weight: bold;">۸۵</div>
<div style="font-size: 14px; opacity: 0.9;">توکن/ثانیه</div>
<hr style="border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 20px;">۵۲</div>
<div style="font-size: 14px; opacity: 0.9;">سایر مدل‌ها</div>
</td>
<td align="center" width="25%">
<div style="font-size: 36px; margin-bottom: 10px;">💾</div>
<div style="font-weight: bold;">مصرف حافظه</div>
<div style="font-size: 28px; margin-top: 10px; font-weight: bold;">۷.۲</div>
<div style="font-size: 14px; opacity: 0.9;">گیگابایت</div>
<hr style="border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 20px;">۲۴.۰</div>
<div style="font-size: 14px; opacity: 0.9;">سایر مدل‌ها</div>
</td>
<td align="center" width="25%">
<div style="font-size: 36px; margin-bottom: 10px;">🎯</div>
<div style="font-weight: bold;">دقت فارسی</div>
<div style="font-size: 28px; margin-top: 10px; font-weight: bold;">۹۴٪</div>
<div style="font-size: 14px; opacity: 0.9;">یاسین</div>
<hr style="border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 20px;">۷۸٪</div>
<div style="font-size: 14px; opacity: 0.9;">سایر مدل‌ها</div>
</td>
</tr>
</table>

</div>

</div>

---

## 🎓 آموزش و فاین‌تیون

<div align="center" style="background: linear-gradient(145deg, #f5f3ff, #ede9fe); padding: 35px; border-radius: 30px;">

<h3 style="font-size: 26px; color: #5b21b6; margin-top: 0;">📚 آموزش مدل روی دیتاست دلخواه</h3>

```python
from transformers import Trainer, TrainingArguments
from datasets import load_dataset

# ۱. بارگذاری دیتاست فارسی
dataset = load_dataset("text", data_files={"train": "my_persian_texts.txt"})

# ۲. تنظیم پارامترهای آموزش
training_args = TrainingArguments(
    output_dir="./yasin-finetuned",
    num_train_epochs=3,
    per_device_train_batch_size=4,
    gradient_accumulation_steps=4,
    save_steps=500,
    logging_steps=50,
    learning_rate=2e-5,
    warmup_ratio=0.03,
    fp16=True,  # آموزش با دقت نیمه
    gradient_checkpointing=True,
)

# ۳. شروع آموزش
trainer = Trainer(
    model=model,
    args=training_args,
    train_dataset=dataset["train"],
)

trainer.train()
```

</div>

---

## 🤝 چگونه مشارکت کنم؟

<div align="center" style="background: linear-gradient(145deg, #667eea, #764ba2); padding: 45px; border-radius: 40px; color: white;">

<h2 style="color: white; font-size: 36px; margin-top: 0;">⭐ به خانواده هوش مصنوعی فیبوناچی بپیوندید!</h2>

<p style="font-size: 18px; line-height: 1.8; margin-bottom: 30px;">
ما به مشارکت‌کنندگان علاقه‌مند در تمام سطوح خوشامد می‌گوییم.<br/>
فرقی نمی‌کند برنامه‌نویس هستید یا نه، هر کمکی ارزشمند است!
</p>

<table style="border: none; border-collapse: separate; border-spacing: 20px;">
<tr>
<td align="center">

<div style="background: rgba(255,255,255,0.15); backdrop-filter: blur(10px); padding: 30px; border-radius: 28px; width: 160px; border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 48px;">⭐</div>
<h3 style="color: white; font-size: 20px;">ستاره دادن</h3>
<p style="color: white; opacity: 0.9; font-size: 14px;">ساده‌ترین راه برای حمایت</p>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.15); backdrop-filter: blur(10px); padding: 30px; border-radius: 28px; width: 160px; border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 48px;">🐛</div>
<h3 style="color: white; font-size: 20px;">گزارش باگ</h3>
<p style="color: white; opacity: 0.9; font-size: 14px;">در GitHub Issues گزارش دهید</p>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.15); backdrop-filter: blur(10px); padding: 30px; border-radius: 28px; width: 160px; border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 48px;">📝</div>
<h3 style="color: white; font-size: 20px;">مستندات</h3>
<p style="color: white; opacity: 0.9; font-size: 14px;">بهبود و تکمیل راهنماها</p>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.15); backdrop-filter: blur(10px); padding: 30px; border-radius: 28px; width: 160px; border: 1px solid rgba(255,255,255,0.3);">
<div style="font-size: 48px;">💡</div>
<h3 style="color: white; font-size: 20px;">ایده جدید</h3>
<p style="color: white; opacity: 0.9; font-size: 14px;">پیشنهاد ویژگی‌های جدید</p>
</div>

</td>
</tr>
</table>

</div>

---

## 📜 مجوز و شرایط استفاده

<div align="center" style="background: white; padding: 35px; border-radius: 30px; border: 1px solid #e2e8f0;">

<table style="width: 100%; border: none;">
<tr>
<td align="center" width="15%">
<div style="font-size: 48px;">📄</div>
</td>
<td align="right" width="85%">
<h3 style="margin: 0; color: #1e293b; font-size: 26px;">مجوز Apache 2.0</h3>
<p style="margin: 5px 0 0 0; color: #475569;">آزاد برای استفاده تجاری و غیرتجاری</p>
</td>
</tr>
</table>

<table style="width: 100%; border: none; border-collapse: separate; border-spacing: 20px; margin-top: 20px;">
<tr>
<td width="50%">

<div style="background: #f0fdf4; padding: 25px; border-radius: 20px; border-right: 6px solid #22c55e;">
<h4 style="color: #166534; margin-top: 0; font-size: 20px;">✅ مجاز</h4>
<ul style="list-style: none; padding-right: 0; margin-bottom: 0; font-size: 15px;">
<li style="margin-bottom: 12px;">✓ استفاده تجاری آزاد</li>
<li style="margin-bottom: 12px;">✓ توزیع و تغییر</li>
<li style="margin-bottom: 12px;">✓ استفاده شخصی</li>
<li style="margin-bottom: 12px;">✓ استفاده در پروژه‌های تجاری</li>
</ul>
</div>

</td>
<td width="50%">

<div style="background: #fef2f2; padding: 25px; border-radius: 20px; border-right: 6px solid #ef4444;">
<h4 style="color: #991b1b; margin-top: 0; font-size: 20px;">❌ غیرمجاز</h4>
<ul style="list-style: none; padding-right: 0; margin-bottom: 0; font-size: 15px;">
<li style="margin-bottom: 12px;">✗ ادعای مالکیت مدل</li>
<li style="margin-bottom: 12px;">✗ حذف کپی‌رایت</li>
<li style="margin-bottom: 12px;">✗ مسئولیت خروجی‌ها با کاربر است</li>
<li style="margin-bottom: 12px;">✗ بدون تضمین عملکرد</li>
</ul>
</div>

</td>
</tr>
</table>

</div>

---

## 👥 تیم توسعه و قدردانی

<div align="center" style="background: linear-gradient(145deg, #f8fafc, #f1f5f9); padding: 40px; border-radius: 40px;">

<h3 style="font-size: 32px; color: #0f172a; margin-bottom: 30px;">❤️ تیم یاسین</h3>

<div style="background: white; padding: 30px 50px; border-radius: 30px; box-shadow: 0 15px 35px rgba(0,0,0,0.05); display: inline-block;">

| نقش | نام | ارتباط |
|:---:|:---:|:---:|
| پژوهشگر ارشد | YSNRFD | [WWW.RealRobot.ir](https://realrobot.ir) |
| تاریخ شروع | ۰۲/۰۳/۲۰۲۳ | - |
| وابستگی | Fibonacci AI | - |

</div>

<div style="background: white; padding: 35px; border-radius: 28px; margin-top: 30px;">

<h3 style="font-size: 26px; color: #0f172a; margin-top: 0;">🙏 سپاسگزاری</h3>

<table style="width: 100%; border: none; text-align: right;">
<tr>
<td width="50%">
<ul style="list-style: none; padding-right: 0; font-size: 17px;">
<li style="margin-bottom: 15px;">🤗 جامعه Hugging Face</li>
<li style="margin-bottom: 15px;">🔥 تیم PyTorch</li>
<li style="margin-bottom: 15px;">🦙 پژوهشگران Meta LLaMA</li>
</ul>
</td>
<td width="50%">
<ul style="list-style: none; padding-right: 0; font-size: 17px;">
<li style="margin-bottom: 15px;">🌪️ تیم Mistral AI</li>
<li style="margin-bottom: 15px;">🧠 تیم Google DeepMind</li>
<li style="margin-bottom: 15px;">🇮🇷 جامعه فارسی‌زبان هوش مصنوعی</li>
</ul>
</td>
</tr>
</table>

</div>

</div>

---

## 📬 ارتباط با ما

<div align="center" style="background: linear-gradient(135deg, #1e293b, #0f172a); padding: 45px; border-radius: 40px; color: white;">

<h2 style="color: white; font-size: 36px; margin-top: 0;">🚀 آماده شروع هستید؟</h2>

<table style="border: none; border-collapse: separate; border-spacing: 20px; margin: 30px 0;">
<tr>
<td align="center">

<div style="background: rgba(255,255,255,0.1); padding: 25px; border-radius: 25px; width: 150px;">
<div style="font-size: 32px; margin-bottom: 10px;">📧</div>
<strong style="font-size: 16px;">ایمیل</strong><br/>
<span style="opacity: 0.9; font-size: 14px;">info@RealRobot.ir</span>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.1); padding: 25px; border-radius: 25px; width: 150px;">
<div style="font-size: 32px; margin-bottom: 10px;">📷</div>
<strong style="font-size: 16px;">اینستاگرام</strong><br/>
<span style="opacity: 0.9; font-size: 14px;">@Fibonacci.ai</span>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.1); padding: 25px; border-radius: 25px; width: 150px;">
<div style="font-size: 32px; margin-bottom: 10px;">💬</div>
<strong style="font-size: 16px;">تلگرام</strong><br/>
<span style="opacity: 0.9; font-size: 14px;">T.ME/FibonacciAi</span>
</div>

</td>
<td align="center">

<div style="background: rgba(255,255,255,0.1); padding: 25px; border-radius: 25px; width: 150px;">
<div style="font-size: 32px; margin-bottom: 10px;">🤗</div>
<strong style="font-size: 16px;">Hugging Face</strong><br/>
<span style="opacity: 0.9; font-size: 14px;">/fibonacciai/Iran-v1</span>
</div>

</td>
</tr>
</table>

<div style="background: linear-gradient(145deg, #1a1e2c, #2d3748); padding: 30px; border-radius: 28px; border-bottom: 6px solid #8B5CF6; margin-top: 20px;">

<h3 style="color: white; font-size: 24px; margin-top: 0;">☕ از هوش مصنوعی ایران حمایت کن</h3>

<p style="color: #e2e8f0; font-size: 16px; margin-bottom: 25px;">
با یک فنجان قهوه، به توسعه مدل زبانی فارسی ایران کمک کن!
</p>

<a href="https://coffeebede.com/realrobot" target="_blank" rel="noopener noreferrer" style="display: inline-block; background: linear-gradient(90deg, #8B5CF6, #7C3AED); color: white; padding: 16px 40px; border-radius: 50px; font-size: 20px; font-weight: bold; text-decoration: none; box-shadow: 0 8px 20px rgba(139,92,246,0.3);">
☕ قهوه بده ☕
</a>

<p style="color: #94a3b8; font-size: 14px; margin-top: 20px;">
لینک مستقیم: coffeebede.com/realrobot
</p>

</div>

<hr style="border: 1px solid rgba(255,255,255,0.2); margin: 40px 0;">

<p style="font-size: 22px; font-weight: bold; margin: 20px 0;">⭐ از حمایت شما سپاسگزاریم ⭐</p>

<p style="font-size: 18px; margin: 20px 0;">
توسط تیم جوان ساخته شده با عشق ❤️ برای زبان فارسی 🇮🇷
</p>

<p style="font-size: 14px; opacity: 0.8; margin-top: 30px;">
© 2018-2026 هوش مصنوعی فیبوناچی. تمامی حقوق برای شرکت رئال ربات محفوظ است.
</p>

</div>

---

<div align="center">

**[⬆️ بازگشت به بالا](#-مدل-زبانی-ایران-نسخه-۱-با-معماری-بومی-یاسین-)**

</div>