منصوبے کے بارے میں

Godot RL Agents ایک مکمل طور پر اوپن سورس پیکج ہے جو Godot انجن اور Python پر مبنی مشین لرننگ الگورتھم کے درمیان پل کا کام کرتا ہے، جس سے گیم ڈویلپرز، AI محققین، اور شوقین افراد غیر کھلاڑی کرداروں (NPCs) یا ایجنٹس کے لیے پیچیدہ رویے تربیت دے سکتے ہیں۔ ریپوزٹری فراہم کرتی ہے: - Godot انجن میں بنائی گئی گیمز اور Python میں چلنے والے مشین لرننگ الگورتھم کے درمیان ایک انٹرفیس۔ - چار معروف RL فریم ورکس کے لیے ریپرز: StableBaselines3، Sample Factory، Ray RLLib، اور CleanRL۔ - LSTM یا اٹینشن پر مبنی انٹرفیس استعمال کرتے ہوئے میموری پر مبنی ایجنٹس کی حمایت۔ - 2D اور 3D دونوں گیمز کی حمایت۔ - ایجنٹ کی گیم کی دنیا کو مشاہدہ کرنے کی صلاحیت بڑھانے کے لیے AI سینسرز کا ایک مجموعہ۔ - Godot اور Godot RL Agents مکمل طور پر مفت اور اوپن سورس ہیں، MIT لائسنس کے تحت۔ یہ پروجیکٹ AAAI-2022 ورکشاپ پیپر (arXiv:2112.03636) میں تفصیل سے بیان کیا گیا ہے۔ ## فوری آغاز گائیڈ فوری آغاز گائیڈ صارفین کو StableBaselines3 بیک اینڈ کے ساتھ شروع کرنے میں مدد دیتا ہے، جو Windows، Mac، اور Linux کو سپورٹ کرتا ہے۔ ایک ویڈیو ٹیوٹوریل بھی دستیاب ہے۔ ### تنصیب اور پہلی تربیت 1. لائبریری انسٹال کریں: `pip install godot-rl` 2. ہب سے مثال کے ماحول ڈاؤن لوڈ کریں، مثلاً `gdrl.env_from_hub -r edbeeching/godot_rl_JumperHard` 3. اگر ضرورت ہو تو گیم ایگزیکیوٹیبل میں رن کی اجازتیں شامل کریں۔ 4. Stable Baselines 3 مثال اسکرپٹ کا استعمال کرتے ہوئے تربیت اور ویژولائزیشن کریں: ```bash python examples/stable_baselines3_example.py --env_path=examples/godot_rl_JumperHard/bin/JumperHard.x86_64 --experiment_name=Experiment_01 --viz ``` ### ایڈیٹر میں انٹرایکٹو تربیت صارفین گیم ایگزیکیوٹیبل ایکسپورٹ کیے بغیر براہ راست Godot ایڈیٹر میں ایجنٹس کو تربیت دے سکتے ہیں۔ اقدامات میں Godot 4 .NET ورژن ڈاؤن لوڈ کرنا، مثال پروجیکٹ درآمد کرنا، اور تربیتی اسکرپٹ چلانا شامل ہے۔ ### ٹیوٹوریلز - کسٹم ماحول ٹیوٹوریل - نئے سینسرز کا استعمال کرتے ہوئے سادہ ماحول ٹیوٹوریل - سڑک پار کرنے والی منی گیم ٹیوٹوریل - نقلی تعلیم (imitation learning) ٹیوٹوریل ### ONNX فارمیٹ میں تربیت یافتہ ایجنٹس ایکسپورٹ اور لوڈ کرنا تازہ ترین ورژن Stable Baselines 3، RLLib، اور CleanRL کے ساتھ ONNX ماڈلز کے لیے تجرباتی حمایت فراہم کرتا ہے۔ صارفین تربیت یافتہ ماڈل ایکسپورٹ کر سکتے ہیں اور اسے مونو ورژن اور پلگ ان کا استعمال کرتے ہوئے Godot ایڈیٹر میں لوڈ کر سکتے ہیں۔ ## جدید استعمال Godot RL Agents چار مختلف RL تربیتی فریم ورکس کو سپورٹ کرتا ہے، ہر ایک کے ساتھ تفصیلی رہنما موجود ہیں: - StableBaselines3 (Windows, Mac, Linux) - Sample Factory (Mac, Linux) - CleanRL (Windows, Mac, Linux) - Ray RLLib (Windows, Mac, Linux) ## تعاون تعاون کا خیرمقدم ہے، بشمول نئے ماحول، readme میں بہتری، اور Python کوڈبیس میں اضافہ۔ اس عمل میں ریپو کو فورک کرنا، کلون کرنا، ورچوئل ماحول بنانا، اور قابل تدوین تنصیب کرنا شامل ہے۔ ٹیسٹ `make test` سے، کوڈ فارمیٹنگ `make style` اور `make quality` سے چلائی جا سکتی ہے۔ ## عمومی سوالات - **Godot RL Agents کیوں تیار کیا گیا؟** ڈیپ RL تحقیق اور گیم ڈویلپمنٹ کے لیے ایک مفت اور اوپن سورس ٹول فراہم کرنے، منفرد NPC رویے قابل بنانے، اور خودکار گیم پلے ٹیسٹنگ کی اجازت دینے کے لیے۔ - **تعاون کیسے کریں؟** اسے آزمائیں، بگز تلاش کریں، مسائل اٹھائیں، یا پل ریکویسٹ جمع کریں۔ - **Mac سپورٹ؟** اب کام کرنا چاہیے۔ - **Unity ML Agents سے مماثلت؟** Unity ML Agents سے متاثر ہے لیکن اس کا مقصد زیادہ کمپیکٹ، مختصر، اور ہیک ایبل ہونا ہے جس میں کم تجرید ہو۔ - **تربیت کے دوران وقفے وقفے سے جمنا؟** ڈیفالٹ SB3 اسکرپٹ کے ساتھ عام ہے جب ماڈل اپ ڈیٹ ہوتا ہے؛ ONNX میں ایکسپورٹ کرنے سے تیز اندازہ لگانا ممکن ہوتا ہے۔ ## لائسنس Godot RL Agents MIT لائسنس یافتہ ہے۔ "کارٹون پلین" اثاثہ Creative Commons Attribution کے تحت ہے۔ ## حوالہ پیپر کا حوالہ دینے کے لیے BibTeX اندراج فراہم کیا گیا ہے۔ ## اعتراف Godot انجن کے مصنفین، Sample Factory، CleanRL، Ray، اور Stable Baselines کے ڈویلپرز، اور الہام کے لیے Unity ML Agents Toolkit کے تخلیق کاروں کا شکریہ۔