Lux Design S1
1.0.0
الليلة مظلمة ومليئة بالأمر. يجب على فريقين محاربة الظلام ، وجمع الموارد ، والتقدم عبر العصور. يجد النهار اندفاعًا يائسًا لجمع وبناء الموارد التي يمكن أن تنقلك خلال الليلة الوشيكة. خطط وتوسيع بعناية - سيتم استهلاك أي مدينة تفشل في إنتاج ما يكفي من الضوء بواسطة الظلام.
مرحبًا بك في Lux AI Challenge Season 1!
إن Lux AI Challenge هو مسابقة حيث يقوم المنافسون بتصميم وكلاء لمعالجة التحسين متعدد المتغيرات وجمع الموارد ومشكلة التخصيص في سيناريو 1v1 ضد المنافسين الآخرين. بالإضافة إلى التحسين ، يجب أن يكون الوكلاء الناجحون قادرين على تحليل خصومهم وتطوير السياسات المناسبة للحصول على اليد العليا.
للبدء ، انتقل إلى قسم البدء لدينا. تستمر المسابقة حتى 6 ديسمبر 2021 واتخاذ الطلبات في الساعة 11:59 مساءً بالتوقيت العالمي على صفحة المنافسة: https://www.kaggle.com/c/lux-ai-2021
بفضل رعاةنا Quantco و J Ventures و Qaimera ، لدينا مجموعة جوائز بقيمة 10،000 دولار إلى جانب العديد من الجوائز الأخرى غير النقدية هذا العام! لمزيد من المعلومات ، راجع https://www.lux-ai.org/sponsors-2021
تأكد من الانضمام إلى خلاف مجتمعنا على https://discord.gg/awjt3uacgn للدردشة والاستراتيجية والتعلم مع المنافسين الآخرين! سنقوم بنشر إعلانات على منتديات Kaggle وعلى الخلاف.
تم بناء هذا من قبل فريق Lux AI Challenge ، باستخدام حزمة Dists.
يمكن العثور على مواصفات الموسم الأول هنا: https://lux-ai.org/specs-2021. هذه التفاصيل كيف تعمل اللعبة وما هي القواعد التي يجب على وكيلك الالتزام بها.
ستحتاج إلى Node.js الإصدار 12 أو أعلى. انظر تعليمات التثبيت هنا ، يمكنك فقط تنزيل الإصدار الموصى به.
تفاصيل الأجزاء التالية الإعداد الموصى به لتطوير الروبوت والتنافس عليه. للمستخدمين الذين يرغبون في استخدام دفاتر Python و Jupyter / Kaggle التفاعلية ، لا تتردد في تخطي هذا القسم واتباع دفتر البرنامج التعليمي
افتح سطر الأوامر ، وقم بتثبيت تصميم المنافسة مع
npm install -g @lux-ai/2021-challenge@latest
قد تتجاهل أي تحذيرات تظهر ، تلك غير ضارة. لتشغيل مباراة من سطر الأوامر (CLI) ، ما عليك سوى التشغيل
lux-ai-2021 path/to/botfile path/to/otherbotfile
وسيتم تشغيل المباراة مع بعض سجلات الأخطاء في التسجيل وتخزينها وإعادة تشغيل في مجلد New errorlogs ومجلد replays . ستتضمن السجلات المخزنة في errorlogs جميع إخراج الأخطاء وأي شيء مطبوع إلى خطأ قياسي من قبل وكيلك. يمكنك مشاهدة إعادة التشغيل المخزنة في مجلد Replays باستخدام Visualizer. لمشاهدة إعادة التشغيل محليًا ، اتبع الإرشادات هنا https://github.com/lux-ai-challenge/luxviewer2021/
للحصول على قائمة كاملة بالأوامر من CLI ، قم بتشغيل
lux-ai-2021 --help
أو انتقل إلى القسم التالي لمعرفة المزيد من الإرشادات حول كيفية استخدام أداة سطر الأوامر ، بما في ذلك توليد عمليات الإعادة الواردة وتشغيل ألواح المتصدرين المحلية للتقييم. يمكنك أيضًا تشغيل كل هذا في Docker باستخدام ملف cli.sh في هذا الريبو ، انظر التعليمات هنا.
كل لغة برمجة لديها مجموعة بداية ، يمكنك العثور على وثائق API العامة هنا: https://github.com/lux-ai-challenge/lux-design-2021/tree/master/kits
يحمل مجلد KITS في هذا المستودع جميع مجموعات المبتدئين المتاحة التي يمكنك استخدامها لبدء التنافس وبناء وكيل منظمة العفو الدولية وإظهار كيفية البدء في لغتك المفضلة وتشغيل تطابق مع هذا الروبوت. نوصي بشدة بالقراءة من خلال الوثائق الخاصة بلغتك المفضلة في الروابط أدناه
هناك أيضًا العديد من الأدوات المقدمة للمجتمع لمساعدة الأشخاص على بناء روبوتات أفضل ، لا تتردد في التحقق من ذلك واستخدام أي ما يناسب احتياجاتك
هل تريد استخدام لغة أخرى ولكنها غير مدعومة؟ لا تتردد في اقتراح تلك اللغة لقضايانا أو حتى أفضل ، وإنشاء مجموعة بداية للمجتمع لاستخدامها وجعل العلاقات العامة لهذا المستودع. راجع مستندنا المساهمين. لمزيد من المعلومات حول هذا الموضوع.
للبقاء على اطلاع على التغييرات والتحديثات على المسابقة والمحرك ، شاهد إعلانات على المنتديات أو الخلاف. انظر https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md للحصول على سجل تغيير كامل.
أداة CLI لديها العديد من الخيارات. على سبيل المثال ، هناك خيار واحد هو البذرة وضبط بذرة 100 ببساطة تشغيل
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
والتي ستجري مباراة باستخدام البذور 100.
يمكنك إخبار أداة CLI بما إذا كنت تريد تخزين سجلات الوكيل أو مطابقة إعادة الإعادة عبر --storeLogs, --storeReplay . اضبط هذه الخيارات المنطقية مثل ذلك
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
بشكل افتراضي ، ستقوم الأداة بإنشاء الحد الأدنى ، المستندة إلى الإجراءات ، التي تكون صغيرة الحجم وتعمل في المرئي ، ولكنها لا تحتوي على معلومات الحالة على سبيل المثال الموارد على الخريطة في كل منعطف. لإنشاء عمليات إعادة إمكانية ، قم بتعيين خيار --statefulReplay إلى True. لتحويل إعادة تشغيل القائمة على الإجراء إلى واحد ، قم بتعيين الخيار- --convertToStateful إلى True وتمرير الملف إلى التحويل.
اختر أين يتم تخزين ملف إعادة التشغيل عن طريق الإعداد --out=path/to/file.json
يمكنك أيضًا تغيير مستويات التسجيل عن طريق الإعداد --loglevel=x للرقم x من 0 إلى 4. الافتراضي هو 2 الذي سيطبع إلى المحطة المحطة جميع تحذيرات اللعبة والأخطاء.
يمكنك تشغيل اللوحة / البطولة المحلية الخاصة بك لتقييم العديد من الروبوتات مرة واحدة عبر
lux-ai-2021 --rankSystem="trueskill" --tournament path/to/agent1 path/to/agent2 path/to/agent3 path/to/agent4 ...
سيؤدي ذلك إلى تشغيل لوحة المتصدرين في ترتيب Trueskill وطباعة نتائج كجدول وحدة التحكم الخاصة بك. وكلاء متطابقون مع المعارضين مع تقييمات مماثلة. الموصى بها لإضافة --storeReplay=false --storeLogs=false لأن السماح لهذا التشغيل لفترة طويلة سيؤدي إلى إنشاء الكثير من ملفات الإعادة وملفات السجل.
انظر lux-ai-2021 --help لمزيد من الخيارات.
تتطابق هذه الأداة مع Lux-AI-2021 تمامًا ، ولكنها تعمل على Ubuntu 18.04 ، وهو النظام المستهدف الذي تستخدمه خوادم المنافسة. تأكد أولاً من تثبيت Docker
لاستخدام أداة Lux-Ai-2021 CLI ، ما عليك سوى الاتصال bash cli.sh وسوف تقبل نفس الوسائط الدقيقة. في المدى الأول ، سيتم إنشاء صورة Docker وتشغيل حاوية في الخلفية. فستكون عمليات التشغيل في المستقبل أسرع بكثير. علاوة على ذلك ، يستخدم هذا حبل ربط ، بحيث يمكنك تحرير الملفات محليًا على جهاز الكمبيوتر الخاص بك وسيعكسها في حاوية Docker والعكس بالعكس.
التحذير الوحيد من هذه الأداة هو أنه لا يمكن الوصول إلى الملفات في الدلائل فوق دليل العمل الحالي (إخراج أمر pwd ).
علاوة على ذلك ، لن ترث هذه الأداة نفس حزم Python المثبتة على جهاز الكمبيوتر الخاص بك. لإضافة حزم ، يرجى تنزيل Dockerfile من هذا الريبو في نفس الدليل مثل ملف cli.sh وإضافة أوامر تثبيت مثل ذلك إلى أسفل الملف
RUN pip3 install <package_name>
بعد تغيير Dockerfile ، قم بتشغيل bash cli.sh clean لتنظيف أشياء Docker القديمة ثم استخدم cli.sh كالمعتاد.
هذه قائمة بجميع أدوات المجتمع التي بنيها مجتمعنا!
انظر الدليل على المساهمة
التصميم الأصلي للموسم الأول يتخيله بوفارد والحجر
تصميم UI/UX بواسطة ISA
بمساعدة اختبار التوازن من ديفيد
نود أن نشكر ثلاثة رعاة ، Quantco ، J Ventures ، و Qaimera هذا العام على السماح لنا بتوفير تجمع جوائز وفرص مثيرة لمنافسينا! لمزيد من المعلومات حولهم ، تحقق منها هنا: https://www.lux-ai.org/sponsors-2021
إذا كنت تستخدم بيئة Lux AI Season 1 في عملك ، فيرجى الاستشهاد بهذا المستودع
@software{Lux_AI_Challenge_S1,
author = {Doerschuk-Tiberi, Bovard and Tao, Stone},
month = {7},
title = {{Lux AI Challenge Season 1}},
url = {https://github.com/Lux-AI-Challenge/Lux-Design-2021},
version = {1.0.0},
year = {2021}
}
