Lux Design S1
1.0.0
밤은 어둡고 공포로 가득합니다. 두 팀은 어둠과 싸우고, 자원을 모으고, 시대를 통과해야합니다. 주간은 임박한 밤을 통해 당신을 운반 할 수있는 자원을 모아서 구축하기 위해 필사적으로 서두르고 있습니다. 신중하게 계획하고 확장하십시오 - 충분한 빛을 생산하지 못하는 도시는 어둠에 의해 소비됩니다.
럭스 AI 챌린지 시즌 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/sponsors-2021을 참조하십시오
https://discord.gg/awjt3uacgn에서 커뮤니티 불일치에 가입하여 채팅, 전략화 및 다른 경쟁자와 배우십시오! 우리는 Kaggle 포럼과 The Discord에 공지 사항을 게시 할 예정입니다.
이것은 Dimensions 패키지를 사용하여 Lux AI Challenge 팀이 구축했습니다.
시즌 1 사양은 여기에서 찾을 수 있습니다 : https://lux-ai.org/specs-2021. 이러한 게임의 작동 방식과 대리인이 준수 해야하는 규칙을 자세히 설명합니다.
Node.js 버전 12 이상이 필요합니다. 설치 지침을 참조하십시오. 권장 버전 만 다운로드 할 수 있습니다.
다음 부분은 봇을 개발하고 경쟁하기 위해 권장되는 설정을 자세히 설명합니다. Python 및 Jupyter Notebooks / Kaggle 대화식 노트북을 사용하려는 사용자의 경우이 섹션을 건너 뛰고 튜토리얼 노트북을 따르십시오.
명령 줄을 열고 경쟁 디자인을
npm install -g @lux-ai/2021-challenge@latest
당신은 나타나는 경고를 무시할 수 있습니다. 명령 줄 (CLI)에서 일치하는 경우 간단히 실행하십시오.
lux-ai-2021 path/to/botfile path/to/otherbotfile
그리고 일치는 일부 로깅 및 저장 오류 로그와 새로운 errorlogs 폴더에서 replays 및 폴더를 재생하여 실행됩니다. ErrorLogs에 저장된 로그에는 모든 오류 출력 및 에이전트의 표준 오류에 인쇄 된 내용이 포함됩니다. Visualizer를 사용하여 재생 폴더에 저장된 재생을 볼 수 있습니다. 로컬로 리플레이를 보려면 여기서 지침 https://github.com/lux-ai-challenge/luxviewer2021/
CLI의 전체 명령 목록은 실행됩니다.
lux-ai-2021 --help
또는 다음 섹션으로 이동하여 명령 줄 도구를 사용하는 방법에 대한 자세한 내용을보십시오. 명령 줄 도구를 사용하고 평가를 위해 로컬 리더 보드를 실행하는 것을 포함하여 명령 줄 도구를 사용하십시오. 이 저장소에서 cli.sh 파일을 사용하여 Docker 에서이 모든 것을 실행할 수도 있습니다. 여기서 지침을 참조하십시오.
각 프로그래밍 언어에는 스타터 키트가 있습니다. 여기에는 일반 API 문서를 찾을 수 있습니다.
이 저장소의 키트 폴더는 AI 에이전트를 경쟁하고 구축하는 데 사용할 수있는 모든 스타터 키트를 보유하고 선택 언어로 시작하고 해당 봇과 일치하는 방법을 보여줍니다. 아래 링크에서 선택한 언어에 대한 문서를 읽는 것이 좋습니다.
또한 사람들이 더 나은 봇을 만들고 자유롭게 확인하고 필요에 맞는 모든 것을 사용하는 데 도움이되는 많은 커뮤니티 제공 도구가 있습니다.
다른 언어를 사용하고 싶지만 지원되지 않습니까? 우리의 문제에 대한 언어를 제안하거나 더 나은 언어를 제안하고, 커뮤니티 가이 저장소에 PR을 만들 수있는 스타터 키트를 만들어보십시오. 이에 대한 자세한 내용은 Contributing.md 문서를 참조하십시오.
경쟁 및 엔진의 변경 및 업데이트에 대해 최신 정보를 유지하려면 포럼이나 불화에 대한 공지 사항을 확인하십시오. 전체 변경 로그는 https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md를 참조하십시오.
CLI 도구에는 몇 가지 옵션이 있습니다. 예를 들어, 하나의 옵션은 씨앗이며 단순히 실행되는 씨앗을 설정하는 것입니다.
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
Seed 100을 사용하여 일치합니다.
CLI 도구에 --storeLogs, --storeReplay 통해 에이전트 로그를 저장하거나 재생을 매치할지 여부를 알 수 있습니다. 이 부울 옵션을 SO처럼 설정하십시오
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
기본적 으로이 도구는 크기가 작고 비주얼 라이저에서 작동하는 최소의 액션 기반 리플레이를 생성하지만 매 턴마다지도에 리소스가 없습니다. Stateful Replay를 생성하려면 --statefulReplay 옵션을 True로 설정하십시오. 액션 기반 리플레이를 상태의 재생으로 변환하려면 --convertToStateful 옵션을 true로 설정하고 파일을 전달하여 변환합니다.
--out=path/to/file.json 설정하여 재생 파일이 저장된 위치를 선택하십시오.
숫자 X의 숫자 X의 경우 --loglevel=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 패키지를 상속하지 않습니다. 패키지를 추가하려면이 repo에서 dockerfile을 cli.sh 파일과 동일한 디렉토리로 다운로드하고 파일 맨 아래에 설치 명령을 추가하십시오.
RUN pip3 install <package_name>
Dockerfile을 변경 한 후 bash cli.sh clean 하여 오래된 Docker 물건을 청소 한 다음 평소와 같이 cli.sh 사용하십시오.
이것은 우리 커뮤니티가 구축 한 모든 커뮤니티 도구의 목록입니다!
기여에 대한 가이드를 참조하십시오
Bovard and Stone이 자랑스러운 시즌 1의 오리지널 디자인
ISA의 UI/UX 디자인
David의 균형 테스트 도움말
우리는 올해 경쟁 업체들에게 상금 풀과 흥미 진진한 기회를 제공 할 수 있도록 올해 3 명의 스폰서, 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}
}
