Lux Design S1
1.0.0
夜は暗くて恐怖に満ちています。 2つのチームは、暗闇と戦い、リソースを収集し、年齢を経て進む必要があります。昼間は、差し迫った夜を通してあなたを運ぶことができるリソースを集めて構築するための必死の急いでいることを見つけます。慎重に計画し、拡大します - 十分な光を生み出すことができない都市は、暗闇によって消費されます。
Lux AI Challengeシーズン1へようこそ！
Lux AI Challengeは、競合他社が他の競合他社に対する1V1シナリオで多変数の最適化、リソースの収集、割り当ての問題に取り組むためにエージェントを設計する競争です。最適化に加えて、成功したエージェントは、対戦相手を分析し、優位を獲得するための適切なポリシーを開発できる必要があります。
開始するには、開始セクションにアクセスしてください。競争は2021年12月6日まで開催され、提出物は競技ページの午後11時59分UTCの期限があります：https：//www.kaggle.com/c/lux-ai-2021
スポンサーのQuantco、J Ventures、およびQaimeraのおかげで、今年は10,000ドルの賞金プールと他の多くの非金銭的賞品があります。詳細については、https：//www.lux-ai.org/spons-2021を参照してください
https://discord.gg/awjt3uacgnでコミュニティの不一致に参加して、他の競合他社とチャット、戦略、学習してください。 Kaggleフォーラムと不一致に発表を投稿します。
これは、Dimensionsパッケージを使用して、Lux AI Challengeチームによって構築されました。
シーズン1の仕様は、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
また、いくつかのロギングおよび保存エラーログと、新しいerrorlogsフォルダーとreplaysフォルダーにリプレイを使用して試合が実行されます。エラーログに保存されているログには、すべてのエラー出力と、エージェントが標準エラーに印刷するものが含まれます。 Visualizerを使用して、リプレイフォルダーに保存されているリプレイを視聴できます。リプレイをローカルに見るには、ここで指示に従ってくださいhttps://github.com/lux-ai-challenge/luxviewer2021/
CLIからのコマンドの完全なリストについては、実行してください
lux-ai-2021 --help
または、次のセクションに移動して、コマンドラインツールの使用方法に関する詳細な指示を確認します。これには、ステートフルなリプレイの生成や評価のためのローカルリーダーボードの実行などがあります。また、このレポでcli.shファイルを使用してDockerでこれをすべて実行することもできます。ここで手順を参照してください。
各プログラミング言語にはスターターキットがあります。一般的なAPIドキュメントはhttps：//github.com/lux-ai-challenge/lux-design-2021/tree/master/kitsをご覧ください。
このリポジトリのキットフォルダーには、AIエージェントの競合を開始して構築するために使用できるすべての利用可能なスターターキットが保持され、選択した言語を始めて、そのボットとの試合を実行する方法を示します。以下のリンクで選択した言語のドキュメントを読むことを強くお勧めします
また、人々がより良いボットを構築するのを支援するための多くのコミュニティ提供されたツールもあります。あなたのニーズに合ったものを自由にチェックして使用してください
別の言語を使用したいのですが、サポートされていませんか？私たちの問題やさらに良い言語を自由に提案してください。コミュニティが使用するためのスターターキットを作成し、このリポジトリにPRを作成してください。詳細については、converting.mdドキュメントを参照してください。
競争とエンジンの変更と更新について最新情報を入手するには、フォーラムや不和の発表をご覧ください。 https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.mdを参照してください。
CLIツールにはいくつかのオプションがあります。たとえば、1つのオプションはシードであり、100のシードを単純に実行することです
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
Seed100を使用して一致します。
CLIツールに--storeLogs, --storeReplayを介してエージェントログを保存するか、リプレイを一致させるかを知ることができます。これらのブールオプションをそのように設定します
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
デフォルトでは、このツールは、サイズが小さく、Visualizerで動作する最小限のアクションベースのリプレイを生成しますが、各ターンのマップ上のリソースなどの状態情報はありません。ステートフルなリプレイを生成するには、 --statefulReplayオプションをtrueに設定します。アクションベースのリプレイをステートフルなリプレイに変換するには、 --convertToStatefulオプションをTrueに設定し、ファイルを渡して変換します。
リプレイファイルが設定によって保存される場所を選択します--out=path/to/file.json
また、ロギングレベルを0から4までの番号xの--loglevel=xを設定することで変更することもできます。デフォルトは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パッケージを継承しません。パッケージを追加するには、このリポジトリからcli.shファイルと同じディレクトリにdockerfileをダウンロードし、ファイルの下部にインストールコマンドを追加してください
RUN pip3 install <package_name>
dockerfileを変更した後、 bash cli.sh cleanを走らせて古いdockerのものを掃除し、通常どおりcli.sh使用します。
これは、私たちのコミュニティによって構築されたすべてのコミュニティツールのリストです！
貢献に関するガイドを参照してください
BovardとStoneによって考えられたシーズン1のオリジナルデザイン
ISAによるUI/UXデザイン
Davidのバランステストヘルプ
今年、3人のスポンサー、Quantco、J Ventures、Qaimeraに感謝します。それらの詳細については、こちらをご覧ください：https：//www.lux-ai.org/sponsors-2021
仕事でLux AIシーズン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}
}
