Lux Design S1
1.0.0
Malam itu gelap dan penuh teror. Dua tim harus melawan kegelapan, mengumpulkan sumber daya, dan maju selama berabad -abad. Siang hari menemukan terburu -buru untuk mengumpulkan dan membangun sumber daya yang dapat membawa Anda melewati malam yang akan datang. Rencanakan dan perluas dengan hati -hati - kota mana pun yang gagal menghasilkan cahaya yang cukup akan dikonsumsi oleh kegelapan.
Selamat datang di Lux AI Challenge Season 1!
Lux AI Challenge adalah kompetisi di mana agen desain pesaing untuk mengatasi optimasi multi-variabel, pengumpulan sumber daya, dan masalah alokasi dalam skenario 1V1 terhadap pesaing lain. Selain optimasi, agen yang sukses harus mampu menganalisis lawan mereka dan mengembangkan kebijakan yang tepat untuk berada di atas angin.
Untuk memulai, buka bagian kami yang memulai. Kompetisi berlangsung hingga 6 Desember 2021 dan pengiriman akan jatuh tempo pada pukul 11:59 malam UTC di halaman kompetisi: https://www.kaggle.com/c/lux-ai-2021
Berkat sponsor kami Quantco, J Ventures, dan Qaimera, kami memiliki hadiah $ 10.000 bersama dengan banyak hadiah non-moneter lainnya tahun ini! Untuk informasi lebih lanjut, lihat https://www.lux-ai.org/sponsors-2021
Pastikan untuk bergabung dengan perselisihan komunitas kami di https://discord.gg/awjt3uacgn untuk mengobrol, menyusun strategi, dan belajar dengan pesaing lainnya! Kami akan memposting pengumuman di forum Kaggle dan di perselisihan.
Ini dibangun oleh tim Lux AI Challenge, menggunakan paket Dimensi.
Spesifikasi Musim 1 dapat ditemukan di sini: https://lux-ai.org/specs-2021. Detail ini bagaimana permainan bekerja dan apa yang harus diatur oleh agen Anda.
Anda akan membutuhkan Node.js versi 12 atau lebih. Lihat instruksi instalasi di sini, Anda bisa mengunduh versi yang disarankan.
Bagian berikutnya merinci pengaturan yang disarankan untuk mengembangkan dan bersaing bot Anda. Untuk pengguna yang ingin menggunakan buku catatan interaktif Python dan Jupyter / Kaggle, jangan ragu untuk melewatkan bagian ini dan mengikuti buku catatan tutorial
Buka baris perintah, dan pasang desain kompetisi dengan
npm install -g @lux-ai/2021-challenge@latest
Anda dapat mengabaikan peringatan apa pun yang muncul, itu tidak berbahaya. Untuk menjalankan kecocokan dari baris perintah (CLI), cukup jalankan
lux-ai-2021 path/to/botfile path/to/otherbotfile
Dan kecocokan akan berjalan dengan beberapa log logging dan menyimpan log kesalahan dan replay di folder errorlogs baru dan folder replays . Log yang disimpan dalam errorLogs akan mencakup semua output kesalahan dan apa pun yang dicetak untuk kesalahan standar oleh agen Anda. Anda dapat menonton replay yang disimpan di folder replay menggunakan visualizer kami. Untuk menonton replay secara lokal, ikuti instruksi di sini https://github.com/lux--challenge/luxviewer2021/
Untuk daftar lengkap perintah dari CLI, jalankan
lux-ai-2021 --help
Atau buka bagian berikutnya untuk melihat lebih banyak instruksi tentang cara menggunakan alat baris perintah, termasuk menghasilkan replay stateful dan menjalankan papan peringkat lokal untuk evaluasi. Anda juga dapat menjalankan semua ini di Docker menggunakan file cli.sh di repo ini, lihat instruksi di sini.
Setiap bahasa pemrograman memiliki starter kit, Anda dapat menemukan dokumentasi API umum di sini: https://github.com/lux-ai-challenge/lux-design-2021/tree/master/kits
Folder kit di repositori ini menampung semua kit starter yang tersedia yang dapat Anda gunakan untuk mulai bersaing dan membangun agen AI dan menunjukkan kepada Anda bagaimana memulai dengan bahasa pilihan Anda dan menjalankan kecocokan dengan bot itu dapat ditemukan. Kami sangat menyarankan membaca dokumentasi untuk bahasa pilihan Anda di tautan di bawah ini
Ada juga banyak alat yang disediakan komunitas untuk membantu orang membangun bot yang lebih baik, jangan ragu untuk memeriksanya dan menggunakan apa pun yang sesuai dengan kebutuhan Anda
Ingin menggunakan bahasa lain tetapi tidak didukung? Jangan ragu untuk menyarankan bahasa itu untuk masalah kami atau bahkan lebih baik, buat starter kit untuk digunakan masyarakat dan buat PR ke repositori ini. Lihat dokumen Kontribusi.MD kami untuk informasi lebih lanjut tentang ini.
Untuk tetap mendapatkan informasi terbaru tentang perubahan dan pembaruan untuk kompetisi dan mesin, saksikan pengumuman di forum atau perselisihan. Lihat https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md untuk log perubahan penuh.
Alat CLI memiliki beberapa opsi. Misalnya, satu opsi adalah benih dan untuk mengatur benih 100 cukup
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
yang akan menjalankan kecocokan menggunakan seed 100.
Anda dapat memberi tahu alat CLI apakah akan menyimpan log agen atau mencocokkan replay melalui --storeLogs, --storeReplay . Atur opsi boolean ini seperti begitu
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
Secara default alat ini akan menghasilkan minimum, berbasis tindakan , tayangan ulang yang berukuran kecil dan bekerja di visualisator tetapi tidak memiliki informasi status sumber daya misalnya pada peta di setiap belokan. Untuk menghasilkan tayangan ulang yang stateful , atur opsi --statefulReplay ke True. Untuk mengonversi replay berbasis tindakan menjadi stateful, atur --convertToStateful opsi untuk true dan lulus file untuk dikonversi.
Pilih di mana file replay disimpan dengan pengaturan --out=path/to/file.json
Anda juga dapat mengubah level logging dengan pengaturan --loglevel=x untuk angka X dari 0 ke 4. Defaultnya adalah 2 yang akan dicetak ke terminal semua peringatan dan kesalahan game.
Anda dapat menjalankan papan peringkat / turnamen lokal Anda sendiri untuk mengevaluasi beberapa bot sekaligus melalui
lux-ai-2021 --rankSystem="trueskill" --tournament path/to/agent1 path/to/agent2 path/to/agent3 path/to/agent4 ...
Ini akan menjalankan papan peringkat yang diperingkat oleh Trueskill dan mencetak hasil sebagai tabel untuk konsol Anda. Agen dicocokkan secara otomatis dengan lawan dengan peringkat yang sama. Direkomendasikan untuk menambahkan --storeReplay=false --storeLogs=false karena membiarkan ini berjalan untuk waktu yang lama akan menghasilkan banyak replay dan file log.
Lihat lux-ai-2021 --help untuk lebih banyak opsi.
Alat ini cocok dengan Lux-AI-2021 dengan tepat, tetapi berjalan di Ubuntu 18.04, sistem target yang digunakan server kompetisi. Pastikan untuk menginstal Docker terlebih dahulu
Untuk kemudian menggunakan alat CLI LUX-AI-2021, cukup hubungi bash cli.sh dan akan menerima argumen yang sama persis. Pada menjalankan pertama, itu akan membangun gambar Docker dan menjalankan wadah di latar belakang. Lari masa depan kemudian akan jauh lebih cepat. Selain itu, ini menggunakan bind mount, sehingga Anda dapat mengedit file secara lokal di komputer Anda dan mereka akan tercermin dalam wadah Docker dan sebaliknya.
Satu -satunya peringatan dari alat ini adalah bahwa ia tidak memiliki akses ke file di direktori di atas direktori kerja saat ini (output dari perintah pwd ).
Selain itu, alat ini tidak akan mewarisi paket Python yang diinstal yang sama di komputer Anda. Untuk menambahkan paket, silakan unduh DockerFile dari repo ini ke direktori yang sama dengan file cli.sh dan tambahkan perintah instalasi seperti itu ke bagian bawah file
RUN pip3 install <package_name>
Setelah mengubah Dockerfile, jalankan bash cli.sh clean untuk membersihkan barang -barang Docker lama dan kemudian gunakan cli.sh seperti biasa.
Ini adalah daftar semua alat komunitas yang dibangun oleh komunitas kami!
Lihat Panduan tentang Kontribusi
Desain Asli untuk Musim 1 Dicepat oleh Bovard dan Stone
Desain UI/UX oleh ISA
Dengan bantuan pengujian keseimbangan dari David
Kami ingin mengucapkan terima kasih kepada 3 sponsor kami, Quantco, J Ventures, dan Qaimera tahun ini karena mengizinkan kami memberikan kumpulan hadiah dan peluang menarik bagi para pesaing kami! Untuk informasi lebih lanjut tentang mereka, lihat di sini: https://www.lux-ai.org/sponsors-2021
Jika Anda menggunakan lingkungan Lux AI Season 1 dalam pekerjaan Anda, silakan kutip repositori ini karena demikian
@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}
}
