{"id":31508256,"url":"https://github.com/msr7799/atlas-ai","last_synced_at":"2025-10-02T21:37:01.874Z","repository":{"id":308969152,"uuid":"1032193258","full_name":"Msr7799/Atlas-AI","owner":"Msr7799","description":"Cross-platform Flutter AI chat application for Android, Linux, and Windows. Features a fine-tuned agent capable of training other agents (like instructors) using Google's new A2A service.","archived":false,"fork":false,"pushed_at":"2025-09-14T07:25:27.000Z","size":24216,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-14T09:19:33.775Z","etag":null,"topics":["a2a","ai","ai-agents","android","android-app","api-client","arabic-ai","arabic-language","fine","fine-tuning","flutter","flutter-apps","llm","windows"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Msr7799.png","metadata":{"files":{"readme":"README-ar.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-05T00:46:35.000Z","updated_at":"2025-09-14T07:25:31.000Z","dependencies_parsed_at":"2025-09-14T09:10:37.030Z","dependency_job_id":"24a3ce89-71ae-402a-ab35-f37dfcca545e","html_url":"https://github.com/Msr7799/Atlas-AI","commit_stats":null,"previous_names":["msr7799/fine_tuning_ai"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Msr7799/Atlas-AI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Msr7799%2FAtlas-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Msr7799%2FAtlas-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Msr7799%2FAtlas-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Msr7799%2FAtlas-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Msr7799","download_url":"https://codeload.github.com/Msr7799/Atlas-AI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Msr7799%2FAtlas-AI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278078060,"owners_count":25926032,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-02T02:00:08.890Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a2a","ai","ai-agents","android","android-app","api-client","arabic-ai","arabic-language","fine","fine-tuning","flutter","flutter-apps","llm","windows"],"created_at":"2025-10-02T21:37:00.620Z","updated_at":"2025-10-02T21:37:01.865Z","avatar_url":"https://github.com/Msr7799.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Atlas AI - مساعد الذكاء الاصطناعي المتقدم\r\n\r\n![alt text](assets/icons/atlas.png)\r\n[![Flutter Version](https://img.shields.io/badge/Flutter-3.8.1+-blue.svg)](https://flutter.dev/)\r\n[![Dart Version](https://img.shields.io/badge/Dart-3.8.1+-blue.svg)](https://dart.dev/)\r\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\r\n[![Developer](https://img.shields.io/badge/Developer-Mohamed%20S%20AL--Romaihi-blue.svg)](mailto:alromaihi2224@gmail.com)\r\n\u003cimg src=\"https://img.shields.io/badge/♥️%20GitHub-gray?style=for-the-badge\u0026logo=github\u0026logoColor=white\" style=\"border: 2px solid black; border-radius: 10px;\" alt=\"GitHub\"\u003e\r\n\r\n\r\n[![Read in English](https://img.shields.io/badge/Read%20in%20English-%E2%9C%85-white?style=for-the-badge\u0026logo=readme\u0026logoColor=white)](README.md)\r\n\r\n[![Releases](https://img.shields.io/badge/Releases-green?style=for-the-badge\u0026logo=github)](https://github.com/Msr7799/Atlas-AI/releases)\r\n\r\n## نظرة عامة\r\n\r\nAtlas AI هو تطبيق مساعد ذكي متطور مبني بـ Flutter، يتميز بالدعم الأصلي للغة العربية والقدرات المتقدمة في المحادثة. يدمج التطبيق نماذج ذكاء اصطناعي متعددة ويوفر تجربة سلسة متعددة المنصات مع تصميم واجهة مستخدم حديثة وتحسينات أداء قوية.\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ctable\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot1.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot2.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot3.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n    \u003ctr\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot4.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot5.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n      \u003ctd align=\"center\" style=\"padding: 50px;\"\u003e\r\n        \u003cimg src=\"assets/icons/screenshot6.png\" width=\"180\" height=\"370\" style=\"border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.2), 0 6px 20px 0 rgba(0,0,0,0.19);\" /\u003e\r\n      \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n  \u003c/table\u003e\r\n\u003c/div\u003e\r\n\r\n## ✨ المميزات الرئيسية\r\n\r\n\r\n[![Features](https://img.shields.io/badge/Features-%E2%9C%85-white?style=for-the-badge\u0026logo=readme\u0026logoColor=white)](FEATURES-ar.md)\r\n\r\n\r\n\u003cimg src=\"assets/icons/app_icon.png\" width=\"150\" height=\"150\" /\u003e\r\n\r\n### 🤖 **تكامل نماذج ذكاء اصطناعي متعددة**\r\n- **نماذج Groq**: 10 نماذج مختلفة بما في ذلك Llama 3.1 و Mixtral و Gemma\r\n- **خدمة GPTGod**: 17 نموذج متقدم مع دعم GPT-4\r\n- **بحث Tavily**: تكامل البحث في الويب في الوقت الفعلي\r\n- **Hugging Face**: الوصول إلى النماذج مفتوحة المصدر\r\n- **الذكاء الاصطناعي المحلي**: دعم النماذج غير المتصلة بالإنترنت\r\n\r\n### 🌐 **دعم اللغات**\r\n- **دعم أصلي للعربية**: تخطيط RTL كامل ومعالجة اللغة العربية\r\n- **واجهة متعددة اللغات**: واجهة مستخدم بالإنجليزية والعربية\r\n- **محتوى محلي**: ردود متفهمة للسياق باللغة العربية\r\n\r\n### 🎨 **واجهة مستخدم حديثة**\r\n- **Material Design 3**: نظام تصميم حديث ومتجاوب\r\n- **الوضع المظلم/الفاتح**: ثيمات ديناميكية مع تفضيلات المستخدم\r\n- **متعدد المنصات**: تجربة متسقة عبر جميع المنصات\r\n- **إمكانية الوصول**: دعم كامل لإمكانية الوصول\r\n\r\n### 🔧 **القدرات المتقدمة**\r\n\r\n[![MCP Setup](https://img.shields.io/badge/MCP_Setup-%E2%9C%85-white?style=for-the-badge\u0026logo=readme\u0026logoColor=white)](mcp.md)\r\n\r\n- **مستشار الضبط الدقيق**: توصيات ذكية لتدريب النماذج\r\n- **تكامل MCP**: بروتوكول سياق النموذج للذاكرة المحسنة [!\r\n- **إدخال صوتي**: وظيفة تحويل الكلام إلى نص\r\n- **تصدير الدردشة**: تنسيقات تصدير متعددة (JSON، CSV، TXT)\r\n- **تحسين الأداء**: إدارة متقدمة للذاكرة والموارد\r\n\r\n### 🔐 **الأمان والخصوصية**\r\n- **إدارة مفاتيح API**: تخزين وإدارة آمنة للمفاتيح\r\n- **تخزين البيانات المحلية**: قاعدة بيانات SQLite مع التشفير\r\n- **إدارة الأذونات**: ضوابط وصول دقيقة\r\n- **الخصوصية أولاً**: لا يتم إرسال البيانات إلى خوادم خارجية دون موافقة\r\n\r\n## 🚀 البدء السريع\r\n\r\n### المتطلبات المسبقة\r\n\r\n- Flutter SDK 3.8.1 أو أحدث\r\n- Dart SDK 3.8.1 أو أحدث\r\n- Android Studio / VS Code\r\n- Git\r\n\r\n### التثبيت\r\n\r\n1. **استنساخ المستودع**\r\n   ```bash\r\n   git clone https://github.com/Msr7799/Atlas-AI.git\r\n   cd Atlas-AI\r\n   ```\r\n\r\n2. **تثبيت التبعيات**\r\n   ```bash\r\n   flutter pub get\r\n   ```\r\n\r\n3. **تكوين متغيرات البيئة**\r\n   ```bash\r\n   cp example_.env .env\r\n   # تحرير ملف .env مع مفاتيح API الخاصة بك (اختياري - التطبيق يتضمن مفاتيح افتراضية)\r\n   ```\r\n\r\n4. **تشغيل التطبيق**\r\n   ```bash\r\n   flutter run\r\n   ```\r\n\r\n## 📱 دعم المنصات\r\n\r\n| المنصة | الحالة | ملاحظات |\r\n|----------|--------|-------|\r\n| Android | ✅ | دعم كامل |\r\n| iOS | ✅ | دعم كامل |\r\n| Windows | ✅ | دعم كامل |\r\n| Linux | ✅ | دعم كامل |\r\n| Web | ✅ | ميزات محدودة |\r\n\r\n## 🏗️ بنية المشروع\r\n\r\n```\r\nlib/\r\n├── 🔧 core/                    # النواة الأساسية\r\n│   ├── config/                 # إعدادات التطبيق\r\n│   │   └── app_config.dart\r\n│   ├── lifecycle/              # إدارة دورة حياة التطبيق\r\n│   │   └── app_lifecycle_observer.dart\r\n│   ├── monitoring/             # مراقبة التطبيق\r\n│   │   └── app_monitor.dart\r\n│   ├── performance/            # تحسينات الأداء\r\n│   │   ├── app_optimizer.dart\r\n│   │   ├── database_optimizer.dart\r\n│   │   ├── image_optimizer.dart\r\n│   │   ├── network_optimizer.dart\r\n│   │   ├── performance_manager.dart\r\n│   │   ├── performance_optimizer.dart\r\n│   │   └── performance_report.dart\r\n│   ├── services/               # الخدمات الأساسية\r\n│   │   ├── advanced_model_training_service.dart\r\n│   │   ├── api_key_manager.dart\r\n│   │   ├── base_ai_service.dart\r\n│   │   ├── base_api_service.dart\r\n│   │   ├── chat_export_service.dart\r\n│   │   ├── enhanced_mcp_service.dart\r\n│   │   ├── fine_tuning_advisor_service.dart\r\n│   │   ├── gptgod_service.dart\r\n│   │   ├── groq_service.dart\r\n│   │   ├── huggingface_service.dart\r\n│   │   ├── lazy_service_initializer.dart\r\n│   │   ├── local_ai_service.dart\r\n│   │   ├── mcp_service.dart\r\n│   │   ├── openrouter_service.dart\r\n│   │   ├── permissions_manager.dart\r\n│   │   ├── prompt_enhancer_service.dart\r\n│   │   ├── speech_service.dart\r\n│   │   ├── tavily_service.dart\r\n│   │   └── unified_ai_service.dart\r\n│   ├── theme/                  # نظام الثيمات\r\n│   │   └── app_theme.dart\r\n│   ├── utils/                  # أدوات مساعدة\r\n│   │   ├── app_utils.dart\r\n│   │   ├── asset_optimizer.dart\r\n│   │   ├── logger.dart\r\n│   │   ├── memory_manager.dart\r\n│   │   ├── network_checker.dart\r\n│   │   ├── performance_monitor.dart\r\n│   │   └── responsive_helper.dart\r\n│   └── widgets/                # عناصر النواة\r\n│       └── optimized_widgets.dart\r\n├── 💾 data/                    # طبقة البيانات\r\n│   ├── datasources/            # مصادر البيانات\r\n│   │   ├── chat_history.db\r\n│   │   └── database_helper.dart\r\n│   ├── models/                 # نماذج البيانات\r\n│   │   ├── message_model.dart\r\n│   │   └── message_model.g.dart\r\n│   └── repositories/           # مستودعات البيانات\r\n│       └── chat_repository.dart\r\n├── 🎨 presentation/            # طبقة العرض\r\n│   ├── constants/              # ثوابت واجهة المستخدم\r\n│   │   └── ui_constants.dart\r\n│   ├── pages/                  # صفحات التطبيق\r\n│   │   ├── advanced_model_training_page.dart\r\n│   │   ├── api_settings_page.dart\r\n│   │   ├── main_chat_page_enhanced.dart\r\n│   │   └── splash_screen.dart\r\n│   ├── providers/              # مزودي الحالة\r\n│   │   ├── chat_provider.dart\r\n│   │   ├── chat_selection_provider.dart\r\n│   │   ├── prompt_enhancer_provider.dart\r\n│   │   ├── settings_provider.dart\r\n│   │   ├── theme_provider.dart\r\n│   │   └── training_provider.dart\r\n│   └── widgets/               # مكونات واجهة المستخدم\r\n│       ├── animated_suggestions_dropdown.dart\r\n│       ├── api_debug_panel.dart\r\n│       ├── attachment_preview.dart\r\n│       ├── chat_app_bar.dart\r\n│       ├── chat_drawer.dart\r\n│       ├── chat_export_dialog.dart\r\n│       ├── chat_floating_buttons.dart\r\n│       ├── chat_input_widget.dart\r\n│       ├── chat_message_list.dart\r\n│       ├── chat_search_header.dart\r\n│       ├── compact_message_bubble.dart\r\n│       ├── debug_panel.dart\r\n│       ├── enhanced/           # العناصر المحسنة\r\n│       │   ├── chat_app_bar.dart\r\n│       │   ├── chat_input_area.dart\r\n│       │   ├── chat_message_list.dart\r\n│       │   └── chat_welcome_screen.dart\r\n│       ├── language_selector_widget.dart\r\n│       ├── message_bubble.dart\r\n│       ├── models_info_dialog.dart\r\n│       ├── prompt_enhancement_dialog.dart\r\n│       ├── search_status_widget.dart\r\n│       ├── settings/           # عناصر الإعدادات\r\n│       │   ├── api_keys_section.dart\r\n│       │   ├── compact_settings_dialog.dart\r\n│       │   └── settings_sections.dart\r\n│       ├── settings_dialog.dart\r\n│       ├── thinking_process_widget.dart\r\n│       ├── training/           # عناصر التدريب\r\n│       │   └── unified_training_widget.dart\r\n│       └── voice_input_button.dart\r\n└── main.dart                   # نقطة دخول التطبيق\r\n```\r\n\r\n## 🔧 التكوين\r\n\r\n### إعداد مفاتيح API\r\n\r\nيأتي التطبيق مع مفاتيح API افتراضية للاستخدام الفوري. للإنتاج أو الاستخدام المكثف، قم بتكوين مفاتيحك الخاصة:\r\n\r\n1. انسخ `example_.env` إلى `.env`\r\n2. أضف مفاتيح API الخاصة بك:\r\n   ```\r\n   GROQ_API_KEY=your_groq_key\r\n   GPTGOD_API_KEY=your_gptgod_key\r\n   TAVILY_API_KEY=your_tavily_key\r\n   ```\r\n\r\n### النماذج المتاحة للذكاء الاصطناعي\r\n\r\n#### نماذج Groq (10 متاح)\r\n- Llama 3.1 8B - نموذج سريع ومتوازن\r\n- Llama 3.1 70B - ردود عالية الجودة\r\n- Mixtral 8x7B - تفكير ممتاز\r\n- Gemma 9B - معالجة فعالة\r\n\r\n#### نماذج GPTGod (17 متاح)\r\n- GPT-4 Turbo - أحدث نموذج OpenAI\r\n- Claude 3 Opus - النموذج الرائد من Anthropic\r\n- Gemini Pro - نموذج Google المتقدم\r\n\r\n## 🎯 الاستخدام\r\n\r\n### الدردشة الأساسية\r\n1. قم بتشغيل التطبيق\r\n2. اختر نموذج الذكاء الاصطناعي المفضل لديك\r\n3. ابدأ بالمحادثة بالعربية أو الإنجليزية\r\n\r\n### الإدخال الصوتي\r\n1. اضغط على زر الميكروفون\r\n2. تحدث برسالتك\r\n3. سيقوم التطبيق بنسخ ومعالجة كلامك\r\n\r\n### تدريب النماذج\r\n1. انتقل إلى صفحة تدريب النماذج\r\n2. قم بتكوين معاملات التدريب\r\n3. ارفع بيانات التدريب الخاصة بك\r\n4. راقب تقدم التدريب\r\n\r\n### تصدير المحادثات\r\n1. افتح درج الدردشة\r\n2. اختر \"تصدير الدردشة\"\r\n3. اختر التنسيق (JSON/CSV/TXT)\r\n4. احفظ على الجهاز\r\n\r\n## 🤝 المساهمة\r\n\r\nنرحب بالمساهمات! يرجى اتباع هذه الخطوات:\r\n\r\n1. قم بعمل Fork للمستودع\r\n2. أنشئ فرع ميزة (`git checkout -b feature/amazing-feature`)\r\n3. قم بتأكيد تغييراتك (`git commit -m 'Add amazing feature'`)\r\n4. ادفع إلى الفرع (`git push origin feature/amazing-feature`)\r\n5. افتح طلب سحب\r\n\r\n### إرشادات التطوير\r\n\r\n- اتبع أفضل ممارسات Flutter/Dart\r\n- حافظ على دعم اللغة العربية\r\n- اكتب اختبارات شاملة\r\n- حدث التوثيق\r\n- تأكد من التوافق متعدد المنصات\r\n\r\n## 📄 الترخيص\r\n\r\nهذا المشروع مرخص تحت رخصة MIT - انظر ملف [LICENSE](LICENSE) للتفاصيل.\r\n\r\n## 👨‍💻 المطور\r\n\r\n**Mohamed S AL-Romaihi**\r\n- 📧 البريد الإلكتروني: alromaihi2224@gmail.com\r\n- 🌐 GitHub: [ملفك الشخصي على GitHub](https://github.com/Msr7799)\r\n\r\n## 🐛 تقارير الأخطاء وطلبات الميزات\r\n\r\nإذا واجهت أي مشاكل أو لديك اقتراحات للتحسينات:\r\n\r\n📧 **البريد الإلكتروني**: alromaihi2224@gmail.com\r\n\r\nيرجى تضمين:\r\n- معلومات الجهاز/المنصة\r\n- خطوات إعادة إنتاج المشكلة\r\n- السلوك المتوقع مقابل الفعلي\r\n- لقطات شاشة (إن أمكن)\r\n\r\n## 🙏 شكر وتقدير\r\n\r\n- فريق Flutter للإطار المذهل\r\n- موفري نماذج الذكاء الاصطناعي (Groq، OpenAI، Anthropic)\r\n- مساهمي المجتمع مفتوح المصدر\r\n- مجتمع معالجة اللغة العربية\r\n\r\n---\r\n\r\n**Atlas AI** - تمكين المحادثات بمساعدة الذكاء الاصطناعي الذكي\r\n\r\nتم البناء بـ ❤️ بواسطة Mohamed S AL-Romaihi\r\n- رسوم متحركة متقدمة ومؤثرات بصرية\r\n- دعم الأنماط المظلمة والفاتحة\r\n- واجهة محادثة تفاعلية مع دعم الملفات\r\n\r\n### 🔧 **أدوات تطوير متطورة**\r\n- تكامل مع Tavily API للبحث الذكي\r\n- نظام MCP للذاكرة المتقدمة\r\n- دعم تحليل البيانات المتخصصة\r\n- لوحة تحكم للمطورين (Debug Panel)\r\n\r\n### 📱 **منصات متعددة**\r\n- دعم كامل لأنظمة Android, iOS, Web, Linux, Windows, macOS\r\n- استجابة كاملة لجميع أحجام الشاشات\r\n- أداء محسن لكافة المنصات\r\n\r\n## 🚀 البدء السريع\r\n\r\n### متطلبات النظام\r\n\r\n```bash\r\n# Flutter SDK\r\nFlutter 3.8.1 أو أحدث\r\nDart 3.8.1 أو أحدث\r\n\r\n# أدوات إضافية\r\nGit\r\nNode.js (لخدمات MCP)\r\n```\r\n\r\n### التثبيت\r\n\r\n1. **استنساخ المشروع:**\r\n```bash\r\ngit clone https://github.com/Msr7799/Atlas-AI.git\r\ncd Atlas-AI\r\n```\r\n\r\n2. **تثبيت التبعيات:**\r\n```bash\r\nflutter pub get\r\n```\r\n\r\n3. **إعداد متغيرات البيئة:**\r\n```bash\r\n# إنشاء ملف .env في الجذر\r\ncp .env.example .env\r\n\r\n# تحرير الملف وإضافة مفاتيح API\r\nGROQ_API_KEY=your_groq_api_key_here\r\nTAVILY_API_KEY=your_tavily_api_key_here\r\nTRAVILY_URL_API_PAIRED=your_mcp_endpoint_here\r\nOPENROUTER_API_KEY=your_openrouter_api_key_here\r\n```\r\n\r\n4. **تشغيل التطبيق:**\r\n```bash\r\n# لأجهزة Android/iOS\r\nflutter run\r\n\r\n# للويب\r\nflutter run -d chrome\r\n\r\n# لسطح المكتب\r\nflutter run -d linux   # أو windows أو macos\r\n```\r\n\r\n## 🏗️ معمارية المشروع\r\n\r\n```\r\nlib/\r\n├── 🔧 core/                    # النواة الأساسية\r\n│   ├── config/                 # إعدادات التطبيق\r\n│   │   └── app_config.dart             # إعدادات التطبيق\r\n│   ├── performance/            # تحسينات الأداء\r\n│   │   ├── app_optimizer.dart          # محسن التطبيق\r\n│   │   ├── database_optimizer.dart     # أداء قاعدة البيانات\r\n│   │   ├── image_optimizer.dart        # معالجة الصور\r\n│   │   ├── network_optimizer.dart      # تحسين الشبكة\r\n│   │   ├── performance_optimizer.dart  # الأداء العام\r\n│   │   └── performance_report.dart     # تقارير الأداء\r\n│   ├── services/               # الخدمات الأساسية\r\n│   │   ├── api_key_manager.dart        # إدارة مفاتيح API\r\n│   │   ├── chat_export_service.dart    # خدمة تصدير المحادثات\r\n│   │   ├── fine_tuning_advisor_service.dart # مستشار التدريب المتطور\r\n│   │   ├── gptgod_service.dart         # تكامل GPTGod API\r\n│   │   ├── groq_service.dart           # خدمة Groq AI\r\n│   │   ├── lazy_service_initializer.dart # خدمات التحميل الكسول\r\n│   │   ├── mcp_service.dart            # بروتوكول السياق للنماذج\r\n│   │   ├── model_training_service.dart  # خدمة تدريب النماذج\r\n│   │   ├── prompt_enhancer_service.dart # تحسين الأوامر\r\n│   │   ├── simple_model_training_service.dart # التدريب البسيط\r\n│   │   └── tavily_service.dart         # خدمة البحث الذكي\r\n│   ├── theme/                  # نظام الثيمات\r\n│   │   ├── app_theme.dart              # ثيمات التطبيق\r\n│   │   └── unified_theme.dart          # النظام الموحد للثيمات\r\n│   ├── utils/                  # أدوات مساعدة\r\n│   │   ├── asset_optimizer.dart        # تحسين الأصول\r\n│   │   ├── memory_manager.dart         # إدارة الذاكرة\r\n│   │   ├── performance_monitor.dart    # مراقبة الأداء\r\n│   │   └── speech_stub.dart            # وظائف الصوت\r\n│   └── widgets/                # عناصر النواة\r\n│       └── optimized_widgets.dart      # عناصر محسنة للأداء\r\n├── 💾 data/                    # طبقة البيانات\r\n│   ├── datasources/            # مصادر البيانات\r\n│   │   └── database_helper.dart        # مساعد قاعدة البيانات SQLite\r\n│   ├── models/                 # نماذج البيانات\r\n│   │   ├── attachment_model.dart       # نموذج المرفقات\r\n│   │   ├── message_model.dart          # نموذج رسائل المحادثة\r\n│   │   ├── message_model.g.dart        # كود النموذج المولد\r\n│   │   └── thinking_process_model.dart # نموذج عملية التفكير للذكاء الاصطناعي\r\n│   └── repositories/           # مستودعات البيانات\r\n│       └── chat_repository.dart        # مستودع بيانات المحادثة\r\n├── � presentation/            # طبقة العرض\r\n│   ├── pages/                  # صفحات التطبيق\r\n│   │   ├── api_settings_page.dart      # صفحة إعدادات API\r\n│   │   ├── main_chat_page.dart         # واجهة المحادثة الرئيسية\r\n│   │   └── model_training_page.dart    # صفحة تدريب النماذج\r\n│   ├── providers/              # مزودي الحالة\r\n│   │   ├── chat_provider.dart          # إدارة حالة المحادثة\r\n│   │   ├── chat_selection_provider.dart # حالة اختيار المحادثة\r\n│   │   ├── prompt_enhancer_provider.dart # تحسين الأوامر\r\n│   │   ├── settings_provider.dart      # حالة إعدادات التطبيق\r\n│   │   ├── theme_provider.dart         # إدارة الثيمات\r\n│   │   └── training_provider.dart      # حالة التدريب\r\n│   └── widgets/               # مكونات واجهة المستخدم\r\n│       ├── attachment_preview.dart     # عرض المرفقات\r\n│       ├── chat_drawer.dart            # درج التنقل\r\n│       ├── chat_export_dialog.dart     # حوار التصدير\r\n│       ├── debug_panel.dart            # لوحة تطوير للمطورين\r\n│       ├── message_bubble.dart         # فقاعة رسائل المحادثة\r\n│       ├── prompt_enhancement_dialog.dart # واجهة تحسين الأوامر\r\n│       ├── settings_dialog.dart        # حوار الإعدادات\r\n│       ├── thinking_process_widget.dart # عرض عملية التفكير للذكاء الاصطناعي\r\n│       ├── training_config_widget.dart # إعدادات التدريب\r\n│       ├── training_logs_widget.dart   # عرض سجلات التدريب\r\n│       └── training_progress_widget.dart # عرض تقدم التدريب\r\n└── main.dart                   # نقطة دخول التطبيق\r\n```\r\n\r\n## 🛠️ التقنيات المستخدمة\r\n\r\n### 📱 **تطوير التطبيق**\r\n- **Flutter 3.8.1+** - إطار العمل الأساسي\r\n- **Dart 3.8.1+** - لغة البرمجة\r\n- **Provider** - إدارة الحالة\r\n- **Dio** - طلبات HTTP متقدمة\r\n\r\n### 🤖 **ذكاء اصطناعي**\r\n- **Groq API** - نماذج اللغة المتطورة\r\n- **Tavily API** - البحث الذكي والاستخراج\r\n- **MCP Protocol** - بروتوكول السياق للنماذج\r\n\r\n### 💾 **قاعدة البيانات**\r\n- **SQLite** - قاعدة بيانات محلية\r\n- **Shared Preferences** - تخزين الإعدادات\r\n- **File System** - إدارة الملفات\r\n\r\n### 🎨 **واجهة المستخدم**\r\n- **Material Design 3** - نظام التصميم\r\n- **Google Fonts** - خطوط متنوعة\r\n- **Lottie** - الرسوم المتحركة\r\n- **Flutter Animate** - تأثيرات متقدمة\r\n\r\n## 📖 دليل الاستخدام\r\n\r\n### 💬 **المحادثة الذكية**\r\n1. اكتب رسالتك في حقل النص\r\n2. أرفق ملفات إضافية إذا لزم الأمر\r\n3. اضغط إرسال للحصول على إجابة ذكية\r\n4. استخدم أوامر خاصة مثل `/help` للمساعدة\r\n\r\n### 🔧 **التدريب المتقدم**\r\n```\r\n/finetune [نوع المهمة] - بدء جلسة تدريب متقدم\r\n/analyze [الملف] - تحليل البيانات للتدريب\r\n/optimize [المعاملات] - تحسين النموذج\r\n```\r\n\r\n### 🎨 **تخصيص الواجهة**\r\n- غيّر النمط من الإعدادات (فاتح/مظلم)\r\n- اختر ألوان مخصصة من لوحة الألوان\r\n- اضبط حجم الخط ونوعه\r\n\r\n### 🔍 **البحث الذكي**\r\n```\r\n/search [استعلام] - بحث ذكي في الويب\r\n/crawl [رابط] - استخراج محتوى موقع\r\n/extract [نص] - استخراج معلومات محددة\r\n```\r\n\r\n## ⚙️ الإعدادات المتقدمة\r\n\r\n### 🔑 **مفاتيح API**\r\n\r\nاحصل على مفاتيح API من:\r\n- [Groq Console](https://console.groq.com/) - للذكاء الاصطناعي\r\n- [Tavily API](https://tavily.com/) - للبحث الذكي\r\n\r\n### 🐳 **نشر Docker**\r\n\r\n```dockerfile\r\n# Dockerfile مثال\r\nFROM cirrusci/flutter:stable\r\n\r\nWORKDIR /app\r\nCOPY . .\r\n\r\nRUN flutter pub get\r\nRUN flutter build web\r\n\r\nEXPOSE 8080\r\nCMD [\"flutter\", \"run\", \"-d\", \"web-server\", \"--web-port\", \"8080\"]\r\n```\r\n\r\n### ☁️ **النشر السحابي**\r\n\r\n```bash\r\n# نشر على Firebase Hosting\r\nfirebase deploy\r\n\r\n# نشر على Vercel\r\nvercel --prod\r\n\r\n# نشر على GitHub Pages\r\nflutter build web --base-href=\"/Fine_tuning_AI/\"\r\n```\r\n\r\n## 🤝 المساهمة\r\n\r\nنرحب بمساهماتكم! يرجى اتباع الخطوات التالية:\r\n\r\n1. **Fork** المستودع\r\n2. إنشاء فرع للميزة (`git checkout -b feature/amazing-feature`)\r\n3. Commit التغييرات (`git commit -m 'Add amazing feature'`)\r\n4. Push للفرع (`git push origin feature/amazing-feature`)\r\n5. فتح **Pull Request**\r\n\r\n### 📋 **إرشادات المساهمة**\r\n\r\n- اتبع [دليل أسلوب Dart](https://dart.dev/guides/language/effective-dart/style)\r\n- اكتب اختبارات للميزات الجديدة\r\n- حدث الوثائق عند الحاجة\r\n- استخدم أسماء متغيرات واضحة\r\n\r\n## 🧪 الاختبار\r\n\r\n```bash\r\n# تشغيل جميع الاختبارات\r\nflutter test\r\n\r\n# اختبارات مع تقرير التغطية\r\nflutter test --coverage\r\n\r\n# اختبارات التكامل\r\nflutter test integration_test/\r\n\r\n# تحليل جودة الكود\r\nflutter analyze\r\n```\r\n\r\n## 📊 الأداء\r\n\r\n- **وقت البدء:** \u003c 2 ثانية\r\n- **استهلاك الذاكرة:** \u003c 100 MB\r\n- **حجم التطبيق:** \r\n  - Android: ~25 MB\r\n  - iOS: ~30 MB\r\n  - Web: ~5 MB (مضغوط)\r\n\r\n## 🔒 الأمان\r\n\r\n- تشفير البيانات المحلية\r\n- تأمين مفاتيح API\r\n- عدم تخزين البيانات الحساسة\r\n- اتصالات HTTPS فقط\r\n\r\n## 📝 الترخيص\r\n\r\nهذا المشروع مرخص تحت رخصة MIT - راجع ملف [LICENSE](LICENSE) للتفاصيل.\r\n\r\n## 🙏 شكر وتقدير\r\n\r\n- [Flutter Team](https://flutter.dev/) - إطار العمل الرائع\r\n- [Groq](https://groq.com/) - نماذج الذكاء الاصطناعي المتطورة\r\n- [Tavily](https://tavily.com/) - خدمة البحث الذكي\r\n- [Material Design](https://material.io/) - نظام التصميم\r\n\r\n## 📞 التواصل\r\n\r\n- **المطور:** Mohamed S AL-Romaihi\r\n- **البريد الإلكتروني:** [alromaihi2224@gmail.com](mailto:alromaihi2224@gmail.com)\r\n- **GitHub:** [@Msr7799](https://github.com/Msr7799)\r\n- **المستودع:** [Fine_tuning_AI](https://github.com/Msr7799/Fine_tuning_AI)\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ch3\u003eصنع بـ ❤️ في العالم العربي\u003c/h3\u003e\r\n  \u003cp\u003eإذا أعجبك هذا المشروع، لا تنس إعطاؤه ⭐!\u003c/p\u003e\r\n\u003c/div\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsr7799%2Fatlas-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsr7799%2Fatlas-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsr7799%2Fatlas-ai/lists"}