Lux Design S1
1.0.0
A noite está escura e cheia de terrores. Duas equipes devem lutar contra a escuridão, coletar recursos e avançar através dos tempos. O dia do dia encontra uma corrida desesperada para reunir e construir os recursos que podem levá -lo pela noite iminente. Planeje e expanda com cuidado - qualquer cidade que não produzir luz suficiente será consumida pela escuridão.
Bem -vindo ao Lux Ai Challenge temporada 1!
O Lux AI Challenge é uma competição em que os concorrentes projetam agentes para enfrentar um problema de otimização, coleta de recursos e alocação de vários variáveis em um cenário 1V1 contra outros concorrentes. Além da otimização, os agentes de sucesso devem ser capazes de analisar seus oponentes e desenvolver políticas apropriadas para obter a vantagem.
Para começar, vá para a seção de começar. A competição é dada até 6 de dezembro de 2021 e as inscrições devem ser entregues às 23:59 UTC na página da competição: https://www.kaggle.com/c/lux-ai-2021
Graças aos nossos patrocinadores Quantco, J Ventures e Qaimera, temos um prêmio de US $ 10.000, juntamente com muitos outros prêmios não monetários este ano! Para mais informações, consulte https://www.lux-ai.org/sponsors-2021
Certifique -se de se juntar à nossa discórdia da comunidade em https://discord.gg/awjt3uacgn para conversar, criar estratégias e aprender com outros concorrentes! Estaremos postando anúncios nos fóruns de Kaggle e na discórdia.
Isso foi construído pela equipe Lux AI Challenge, usando o pacote de dimensões.
As especificações da 1ª temporada podem ser encontradas aqui: https://lux-ai.org/specs-2021. Esses detalhes como o jogo funciona e quais regras seu agente deve cumprir.
Você precisará de Node.js versão 12 ou superior. Consulte as instruções de instalação aqui, basta baixar a versão recomendada.
As próximas partes detalham a configuração recomendada para desenvolver e competir seu bot. Para usuários que desejam usar notebooks Python e Jupyter / Kaggle Interactive, fique à vontade para pular esta seção e seguir o caderno do tutorial
Abra a linha de comando e instale o design da competição com
npm install -g @lux-ai/2021-challenge@latest
Você pode ignorar quaisquer avisos que apareçam, esses são inofensivos. Para executar uma partida da linha de comando (CLI), basta executar
lux-ai-2021 path/to/botfile path/to/otherbotfile
e a correspondência será executada com alguns logs de log e armazenamento de logs e uma reprodução em uma nova pasta errorlogs e replays . Os logs armazenados no ErrorLogs incluirão toda a saída de erro e qualquer coisa impressa no erro padrão pelo seu agente. Você pode assistir à reprodução armazenada na pasta Replays usando nosso visualizador. Para assistir a repetição localmente, siga as instruções aqui https://github.com/lux-ai-challenge/luxviewer2021/
Para uma lista completa de comandos da CLI, execute
lux-ai-2021 --help
Ou vá para a próxima seção para ver mais instruções sobre como usar a ferramenta de linha de comando, incluindo a geração de repetições com estado e a execução de tabelas de classificação local para avaliação. Você também pode executar tudo isso no Docker usando o arquivo cli.sh neste repositório, consulte as instruções aqui.
Cada linguagem de programação possui um kit inicial, você pode encontrar documentação geral da API aqui: https://github.com/lux-ai-challenge/lux-design-2021/tree/master/kits
A pasta kits deste repositório detém todos os kits de partida disponíveis para começar a competir e construir um agente de IA e mostrar como começar com o idioma da escolha e executar uma correspondência com esse bot pode ser encontrada. Recomendamos fortemente a leitura da documentação para o seu idioma de escolha nos links abaixo
Também existem muitas ferramentas fornecidas pela comunidade para ajudar as pessoas a construir bots melhores, sentir -se à vontade para verificá -las e usar o que for adequado às suas necessidades
Deseja usar outro idioma, mas não é suportado? Sinta -se à vontade para sugerir essa linguagem para nossos problemas ou melhor ainda, crie um kit inicial para a comunidade usar e faça um PR para este repositório. Consulte nosso documento contribuinte.md para obter mais informações sobre isso.
Para manter -se atualizado sobre as alterações e atualizações da concorrência e do mecanismo, observe os anúncios nos fóruns ou na discórdia. Consulte https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md para um log de alterações completo.
A ferramenta CLI tem várias opções. Por exemplo, uma opção é a semente e definir uma semente de 100 simplesmente correr
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
que executará uma correspondência usando a semente 100.
Você pode dizer à ferramenta CLI se deve armazenar os logs do agente ou corresponder a replays via --storeLogs, --storeReplay . Defina essas opções booleanas como So
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
Por padrão, a ferramenta gerará repetições mínimas baseadas em ação e de tamanho pequeno e funcionará no visualizador, mas não possui informações de informações, por exemplo, recursos no mapa a cada turno. Para gerar replays com estado , defina a opção --statefulReplay como TRUE. Para converter uma reprodução baseada em ação em um com estado, defina a opção --convertToStateful como TRUE e passe o arquivo a ser convertido.
Escolha onde o arquivo de reprodução é armazenado por configuração --out=path/to/file.json
Você também pode alterar os níveis de registro configurando --loglevel=x para o número x de 0 para 4. O padrão é 2, que imprimirá para terminal todos os avisos e erros de jogo.
Você pode executar sua própria tabela / torneio local para avaliar vários bots de uma só vez via
lux-ai-2021 --rankSystem="trueskill" --tournament path/to/agent1 path/to/agent2 path/to/agent3 path/to/agent4 ...
Isso executará uma tabela de classificação classificada pela Trueskill e imprimirá os resultados como uma tabela para o seu console. Os agentes são combinados automaticamente com oponentes com classificações semelhantes. Recomendado para adicionar --storeReplay=false --storeLogs=false como deixar essa execução por um longo tempo gerará muitos replays e arquivos de log.
Consulte lux-ai-2021 --help para obter mais opções.
Essa ferramenta corresponde exatamente ao Lux-AI-2021, mas é executado no Ubuntu 18.04, o sistema de destino que os servidores de competição usam. Certifique -se de instalar primeiro o docker
Para usar a ferramenta CLI Lux-AI-2021, basta ligar para bash cli.sh e ele aceitará os mesmos argumentos exatos. Na primeira execução, ele criará uma imagem do Docker e executará um contêiner em segundo plano. As execuções futuras serão muito mais rápidas. Além disso, isso usa uma montagem de ligação, para que você possa editar arquivos localmente no seu computador e eles se refletirão no contêiner do Docker e vice -versa.
A única ressalva dessa ferramenta é que ela não tem acesso a arquivos nos diretórios acima do diretório de trabalho atual (a saída do comando pwd ).
Além disso, essa ferramenta não herdará os mesmos pacotes Python instalados no seu computador. Para adicionar pacotes, faça o download do Dockerfile deste repositório no mesmo diretório que o arquivo cli.sh e adicione comandos de instalação como assim na parte inferior do arquivo
RUN pip3 install <package_name>
Depois de alterar o DockerFile, execute bash cli.sh clean para limpar o material antigo do Docker e depois use cli.sh como de costume.
Esta é uma lista de todas as ferramentas comunitárias construídas por nossa comunidade!
Veja o guia sobre a contribuição
Design original para a primeira temporada, concebido por Bovard e Stone
Design de Ui/Ux por Isa
Com a ajuda de testes de equilíbrio de David
Gostaríamos de agradecer aos nossos 3 patrocinadores, Quantco, J Ventures e Qaimera este ano por nos permitir fornecer um prêmio e oportunidades interessantes para nossos concorrentes! Para mais informações sobre eles, confira aqui: https://www.lux-ai.org/sponsors-2021
Se você usar o ambiente da 1ª temporada de Lux ai em seu trabalho, cite este repositório como assim
@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}
}
