इस प्रोजेक्ट के बारे में

Godot RL Agents एक पूर्णतः ओपन-सोर्स पैकेज है जो Godot Engine और Python-आधारित मशीन लर्निंग एल्गोरिदम के बीच सेतु का काम करता है, जिससे गेम डेवलपर्स, AI शोधकर्ताओं और शौकीनों को गैर-खिलाड़ी पात्रों (NPC) या एजेंटों के लिए जटिल व्यवहार प्रशिक्षित करने की सुविधा मिलती है। रिपॉजिटरी निम्नलिखित प्रदान करती है: - Godot Engine में बनाए गए गेम्स और 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 संस्करण डाउनलोड करना, उदाहरण परियोजना आयात करना और प्रशिक्षण स्क्रिप्ट चलाना शामिल है। ### ट्यूटोरियल - कस्टम वातावरण ट्यूटोरियल - नए सेंसर का उपयोग करके सरल वातावरण ट्यूटोरियल - सड़क पार करने वाला मिनी-गेम ट्यूटोरियल - अनुकरण सीखने का ट्यूटोरियल ### ONNX प्रारूप में प्रशिक्षित एजेंटों का निर्यात और लोडिंग नवीनतम संस्करण Stable Baselines 3, RLLib और CleanRL के साथ ONNX मॉडल के लिए प्रयोगात्मक समर्थन प्रदान करता है। उपयोगकर्ता एक प्रशिक्षित मॉडल निर्यात कर सकते हैं और mono संस्करण और प्लगइन का उपयोग करके इसे Godot संपादक में लोड कर सकते हैं। ## उन्नत उपयोग Godot RL Agents चार अलग-अलग RL प्रशिक्षण फ्रेमवर्क का समर्थन करता है, प्रत्येक के लिए विस्तृत मार्गदर्शिकाएँ हैं: - StableBaselines3 (Windows, Mac, Linux) - SampleFactory (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 Engine लेखकों, Sample Factory, CleanRL, Ray और Stable Baselines के डेवलपर्स, और प्रेरणा के लिए Unity ML Agents टूलकिट के निर्माताओं को धन्यवाद।