Lux Design S1
1.0.0
La noche está oscura y llena de terrores. Dos equipos deben luchar contra la oscuridad, recolectar recursos y avanzar a través de los siglos. Daytime encuentra una prisa desesperada para reunir y construir los recursos que pueden llevarlo a través de la inminente noche. Planifique y expanda cuidadosamente: la oscuridad consumirá cualquier ciudad que no produzca suficiente luz.
¡Bienvenido a la temporada 1 de Lux AI Challenge!
El Lux AI Challenge es una competencia en la que los competidores diseñan agentes para abordar un problema de optimización múltiple, recursos de recursos y asignación en un escenario de 1V1 contra otros competidores. Además de la optimización, los agentes exitosos deben ser capaces de analizar a sus oponentes y desarrollar políticas apropiadas para obtener la ventaja.
Para comenzar, vaya a nuestra sección inicial. La competencia se extiende hasta el 6 de diciembre de 2021 y las presentaciones deben presentarse a las 11:59 PM UTC en la página de la competencia: https://www.kaggle.com/c/lux-ai-2021
¡Gracias a nuestros patrocinadores Quantco, J Ventures y Qaimera, tenemos un grupo de premios de $ 10,000 junto con muchos otros premios no monetarios este año! Para obtener más información, consulte https://www.lux-ai.org/sponsors-2021
¡Asegúrese de unirse a nuestra discordia comunitaria en https://discord.gg/awjt3uacgn para chatear, estrategias y aprender con otros competidores! Publicaremos anuncios en los foros de Kaggle y en la discordia.
Esto fue construido por el equipo de Lux AI Challenge, utilizando el paquete Dimensions.
Las especificaciones de la temporada 1 se pueden encontrar aquí: https://lux-ai.org/specs-2021. Estos detallan cómo funciona el juego y qué reglas debe cumplir su agente.
Necesitará Node.js versión 12 o superior. Consulte las instrucciones de instalación aquí, puede descargar la versión recomendada.
Las siguientes partes detallan la configuración recomendada para desarrollar y competir su bot. Para los usuarios que desean usar los cuadernos interactivos de Python y Jupyter / Kaggle, no dude en omitir esta sección y seguir el cuaderno de tutorial
Abra la línea de comando e instale el diseño de la competencia con
npm install -g @lux-ai/2021-challenge@latest
Puede ignorar cualquier advertencia que aparezca, esas son inofensivas. Para ejecutar un partido desde la línea de comando (CLI), simplemente ejecute
lux-ai-2021 path/to/botfile path/to/otherbotfile
Y la coincidencia se ejecutará con algunos registros de registro y almacenamiento de errores y una repetición en una nueva carpeta errorlogs y replays . Los registros almacenados en ErrorLogs incluirán toda la salida de error y cualquier cosa impresa al error estándar por parte de su agente. Puede ver la repetición almacenada en la carpeta de repeticiones usando nuestro visualizador. Para ver la repetición localmente, siga las instrucciones aquí https://github.com/lux-ai-challenge/luxviewer2021/
Para una lista completa de comandos de la CLI, ejecute
lux-ai-2021 --help
O vaya a la siguiente sección para ver más instrucciones sobre cómo usar la herramienta de línea de comandos, incluida la generación de repeticiones con estado y la ejecución de tablas de clasificación locales para su evaluación. También puede ejecutar todo esto en Docker usando el archivo cli.sh en este repositorio, consulte las instrucciones aquí.
Cada lenguaje de programación tiene un kit de inicio, puede encontrar documentación general de API aquí: https://github.com/lux-ai-challenge/lux-design-2021/tree/master/kits
La carpeta de kits en este repositorio contiene todos los kits de inicio disponibles que puede usar para comenzar a competir y construir un agente de IA y mostrarle cómo comenzar con su lenguaje de elección y ejecutar una coincidencia con ese bot se puede encontrar. Recomendamos encarecidamente leer la documentación para su idioma de elección en los enlaces a continuación.
También hay muchas herramientas proporcionadas por la comunidad para ayudar a las personas a construir mejores bots, no dude en revisarlos y usar lo que se adapte a sus necesidades.
¿Quieres usar otro idioma pero no es compatible? Siéntase libre de sugerir ese idioma a nuestros problemas o incluso mejor, crear un kit de inicio para que la comunidad use y haga un PR a este repositorio. Consulte nuestro documento Contrabando. MD para obtener más información sobre esto.
Para mantenerse al día sobre los cambios y actualizaciones de la competencia y el motor, observe los anuncios en los foros o la discordia. Consulte https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md para un registro de cambio completo.
La herramienta CLI tiene varias opciones. Por ejemplo, una opción es la semilla y establecer una semilla de 100 simplemente ejecutar
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
que ejecutará un partido usando semillas 100.
Puede decirle a la herramienta CLI si almacenar los registros del agente o las repeticiones de coincidir a través de --storeLogs, --storeReplay . Establezca estas opciones booleanas como SO
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
Por defecto, la herramienta generará repeticiones mínimas, basadas en la acción , que son pequeñas en tamaño y funcionan en el visualizador, pero no tiene información de estado, por ejemplo, recursos en el mapa en cada turno. Para generar repeticiones con estado , establezca la opción --statefulReplay en verdadero. Para convertir una repetición basada en la acción a una estado estatal, establezca la opción --convertToStateful en verdadero y pase el archivo para convertir.
Elija dónde se almacena el archivo de repetición al configurar --out=path/to/file.json
También puede cambiar los niveles de registro configurando --loglevel=x para el número X de 0 a 4. El valor predeterminado es 2 que imprimirá para terminal de todas las advertencias y errores del juego.
Puede ejecutar su propia tabla de clasificación local / torneo para evaluar varios bots a la vez a través de
lux-ai-2021 --rankSystem="trueskill" --tournament path/to/agent1 path/to/agent2 path/to/agent3 path/to/agent4 ...
Esto ejecutará una tabla de clasificación clasificada por Trueskill e imprimirá los resultados como una tabla para su consola. Los agentes se combinan automáticamente con oponentes con calificaciones similares. Recomendado para agregar --storeReplay=false --storeLogs=false como dejar que esto se ejecute durante mucho tiempo generará muchas repeticiones y archivos de registro.
Vea lux-ai-2021 --help para obtener más opciones.
Esta herramienta coincide exactamente con el Lux-AI-2021 exactamente, pero se ejecuta en Ubuntu 18.04, el sistema de destino que usan los servidores de competencia. Asegúrese de instalar First Docker
Para usar la herramienta CLI Lux-AI-2021, simplemente llame bash cli.sh y aceptará los mismos argumentos exactos. En la primera ejecución, construirá una imagen de Docker y ejecutará un contenedor en el fondo. Las carreras futuras serán mucho más rápidas. Además, esto usa un montaje de enlace, por lo que puede editar archivos localmente en su computadora y se reflejarán en el contenedor Docker y viceversa.
La única advertencia de esta herramienta es que no tiene acceso a archivos en directorios por encima del directorio de trabajo actual (la salida del comando pwd ).
Además, esta herramienta no heredará los mismos paquetes de Python instalados en su computadora. Para agregar paquetes, descargue el DockerFile de este repositorio en el mismo directorio que el archivo cli.sh y agregue comandos de instalación como en la parte inferior del archivo
RUN pip3 install <package_name>
Después de cambiar el Dockerfile, ejecute bash cli.sh clean para limpiar las cosas viejas de Docker y luego use cli.sh como de costumbre.
¡Esta es una lista de todas las herramientas comunitarias construidas por nuestra comunidad!
Vea la guía sobre contribución
Diseño original para la temporada 1 concierto por Bovard y Stone
Diseño de UI/UX de ISA
Con ayuda de prueba de equilibrio de David
¡Nos gustaría agradecer a nuestros 3 patrocinadores, Quantco, J Ventures y Qaimera este año por permitirnos proporcionar un grupo de premios y oportunidades emocionantes a nuestros competidores! Para obtener más información sobre ellos, visítelos aquí: https://www.lux-ai.org/sponsors-2021
Si usa el entorno Lux AI Season 1 en su trabajo, cite este repositorio como así
@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}
}
