# Lux-Design-2022
[](https://badge.fury.io/py/luxai2022)
Welcome to the Lux AI Challenge Season 2!
The Lux AI Challenge is a competition where competitors design agents to tackle a multi-variable optimization, resource gathering, and allocation problem in a 1v1 scenario against other competitors. In addition to optimization, successful agents must be capable of analyzing their opponents and developing appropriate policies to get the upper hand.
**We are currently in beta**, so expect unpolished parts and bugs of the engine and visuals.
To get started, go to our [Getting Started](#getting-started) section. The Beta competition runs until December 6 and submissions are due at 11:59PM UTC on the competition page: https://www.kaggle.com/c/lux-ai-2022-beta/
Make sure to join our community discord at https://discord.gg/aWJt3UAcgn to chat, strategize, and learn with other competitors! We will be posting announcements on the Kaggle Forums and on the discord.
Season 2 specifications can be found here: https://lux-ai.org/specs-2022-beta. These detail how the game works and what rules your agent must abide by.
Interested in Season 1? Check out [last year's repository](https://github.com/Lux-AI-Challenge/Lux-Design-2021) where we received 22,000+ submissions from 1,100+ teams around the world ranging from scripted agents to Deep Reinforcement Learning.
## Getting Started
You will need Python >=3.7, <3.11 installed on your system. Once installed, you can install the Lux AI season 2 environment with
```
pip install --upgrade luxai2022
```
To verify your installation, you can run the CLI tool by replacing `path/to/bot/main.py` with a path to a bot (e.g. the starter kit in `kits/python/main.py`) and run
```
luxai2022 path/to/bot/main.py path/to/bot/main.py -v 2 -o replay.json
```
This will turn on logging to level 2, and store the replay file at `replay.json`. For documentation on the luxai2022 tool, see https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/luxai_runner/README.md, which includes details on how to run a local tournament to mass evaluate your agents.
Each programming language has a starter kit, you can find general API documentation here: https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits
The kits folder in this repository holds all of the available starter kits you can use to start competing and building an AI agent. The readme shows you how to get started with your language of choice and run a match. We strongly recommend reading through the documentation for your language of choice in the links below
- [Python](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits/python/)
- [C++](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits/cpp/)
- Javascript - TBA
- Typescript - TBA
- Java - TBA
Want to use another language but it's not supported? Feel free to suggest that language to our issues or even better, create a starter kit for the community to use and make a PR to this repository. See our [CONTRIBUTING.md](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/CONTRIBUTING.md) document for more information on this.
To stay up to date on changes and updates to the competition and the engine, watch for announcements on the forums or the [Discord](https://discord.gg/aWJt3UAcgn). See [ChangeLog.md](https://github.com/Lux-AI-Challenge/Lux-Design-2022/blob/main/ChangeLog.md) for a full change log.
## Community Tools
As the community builds tools for the competition, we will post them here!
3rd Party Viewer - https://github.com/jmerle/lux-eye-2022
## Contributing
See the [guide on contributing](https://github.com/Lux-AI-Challenge/Lux-Design-2022/blob/main/CONTRIBUTING.md)
## Sponsors
To be announced at the official release.
## Core Contributors
We like to extend thanks to some of our early core contributors: [@duanwilliam](https://github.com/duanwilliam) (Frontend), [@programjames](https://github.com/programjames) (Map generation, Engine optimization), and [@themmj](https://github.com/themmj) (C++ kit, Engine optimization).
We further like to extend thanks to contributors during the beta period: [@LeFiz](https://github.com/LeFiz) (Game Design/Architecture).
## Citation
If you use the Lux AI Season 2 environment in your work, please cite this repository as so
```
@software{Lux_AI_Challenge_S1,
author = {Tao, Stone and Doerschuk-Tiberi, Bovard},
month = {10},
title = {{Lux AI Challenge Season 2}},
url = {https://github.com/Lux-AI-Challenge/Lux-Design-2022},
version = {1.0.0},
year = {2022}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Lux-AI-Challenge/Lux-Design-2022",
"name": "luxai2022",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "reinforcement-learning machine-learning ai",
"author": "Lux AI Challenge",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/83/44/3700e3d9e65390d55a84d9fac9fbc2c7b38b5078e1dbaea8ff043a43c6b1/luxai2022-1.1.6.tar.gz",
"platform": null,
"description": "# Lux-Design-2022\n\n[](https://badge.fury.io/py/luxai2022)\n\nWelcome to the Lux AI Challenge Season 2! \n\nThe Lux AI Challenge is a competition where competitors design agents to tackle a multi-variable optimization, resource gathering, and allocation problem in a 1v1 scenario against other competitors. In addition to optimization, successful agents must be capable of analyzing their opponents and developing appropriate policies to get the upper hand. \n\n**We are currently in beta**, so expect unpolished parts and bugs of the engine and visuals.\n\nTo get started, go to our [Getting Started](#getting-started) section. The Beta competition runs until December 6 and submissions are due at 11:59PM UTC on the competition page: https://www.kaggle.com/c/lux-ai-2022-beta/\n\nMake sure to join our community discord at https://discord.gg/aWJt3UAcgn to chat, strategize, and learn with other competitors! We will be posting announcements on the Kaggle Forums and on the discord.\n\nSeason 2 specifications can be found here: https://lux-ai.org/specs-2022-beta. These detail how the game works and what rules your agent must abide by.\n\nInterested in Season 1? Check out [last year's repository](https://github.com/Lux-AI-Challenge/Lux-Design-2021) where we received 22,000+ submissions from 1,100+ teams around the world ranging from scripted agents to Deep Reinforcement Learning.\n\n## Getting Started\n\nYou will need Python >=3.7, <3.11 installed on your system. Once installed, you can install the Lux AI season 2 environment with\n\n```\npip install --upgrade luxai2022\n```\n\n\nTo verify your installation, you can run the CLI tool by replacing `path/to/bot/main.py` with a path to a bot (e.g. the starter kit in `kits/python/main.py`) and run\n\n```\nluxai2022 path/to/bot/main.py path/to/bot/main.py -v 2 -o replay.json\n```\n\nThis will turn on logging to level 2, and store the replay file at `replay.json`. For documentation on the luxai2022 tool, see https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/luxai_runner/README.md, which includes details on how to run a local tournament to mass evaluate your agents.\n\nEach programming language has a starter kit, you can find general API documentation here: https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits\n\nThe kits folder in this repository holds all of the available starter kits you can use to start competing and building an AI agent. The readme shows you how to get started with your language of choice and run a match. We strongly recommend reading through the documentation for your language of choice in the links below\n\n- [Python](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits/python/)\n- [C++](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/kits/cpp/)\n- Javascript - TBA\n- Typescript - TBA\n- Java - TBA\n\nWant to use another language but it's not supported? Feel free to suggest that language to our issues or even better, create a starter kit for the community to use and make a PR to this repository. See our [CONTRIBUTING.md](https://github.com/Lux-AI-Challenge/Lux-Design-2022/tree/main/CONTRIBUTING.md) document for more information on this.\n\nTo stay up to date on changes and updates to the competition and the engine, watch for announcements on the forums or the [Discord](https://discord.gg/aWJt3UAcgn). See [ChangeLog.md](https://github.com/Lux-AI-Challenge/Lux-Design-2022/blob/main/ChangeLog.md) for a full change log.\n\n## Community Tools\nAs the community builds tools for the competition, we will post them here!\n\n3rd Party Viewer - https://github.com/jmerle/lux-eye-2022\n\n## Contributing\nSee the [guide on contributing](https://github.com/Lux-AI-Challenge/Lux-Design-2022/blob/main/CONTRIBUTING.md)\n\n## Sponsors\n\nTo be announced at the official release.\n\n## Core Contributors\n\nWe like to extend thanks to some of our early core contributors: [@duanwilliam](https://github.com/duanwilliam) (Frontend), [@programjames](https://github.com/programjames) (Map generation, Engine optimization), and [@themmj](https://github.com/themmj) (C++ kit, Engine optimization).\n\nWe further like to extend thanks to contributors during the beta period: [@LeFiz](https://github.com/LeFiz) (Game Design/Architecture).\n\n\n## Citation\nIf you use the Lux AI Season 2 environment in your work, please cite this repository as so\n\n```\n@software{Lux_AI_Challenge_S1,\n author = {Tao, Stone and Doerschuk-Tiberi, Bovard},\n month = {10},\n title = {{Lux AI Challenge Season 2}},\n url = {https://github.com/Lux-AI-Challenge/Lux-Design-2022},\n version = {1.0.0},\n year = {2022}\n}\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The Lux AI Challenge Season 2",
"version": "1.1.6",
"split_keywords": [
"reinforcement-learning",
"machine-learning",
"ai"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "487c066fd15cb245ae9aec2a678735c1fe06a63e15719ae7cedd781302484840",
"md5": "89c33cc1f199be9f618d56d85f727065",
"sha256": "fe90ecee6c9c0e05065614fbe2ffe972b4687f4492236446e04791283a88e928"
},
"downloads": -1,
"filename": "luxai2022-1.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "89c33cc1f199be9f618d56d85f727065",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 55544,
"upload_time": "2023-01-04T00:53:44",
"upload_time_iso_8601": "2023-01-04T00:53:44.214577Z",
"url": "https://files.pythonhosted.org/packages/48/7c/066fd15cb245ae9aec2a678735c1fe06a63e15719ae7cedd781302484840/luxai2022-1.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "83443700e3d9e65390d55a84d9fac9fbc2c7b38b5078e1dbaea8ff043a43c6b1",
"md5": "40d8f944db176e7c82c4154e6a1544fd",
"sha256": "0b5cb4c77ada662a5f2afc7e63cb74042113094929369dcda92aab47ae4015c7"
},
"downloads": -1,
"filename": "luxai2022-1.1.6.tar.gz",
"has_sig": false,
"md5_digest": "40d8f944db176e7c82c4154e6a1544fd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 45706,
"upload_time": "2023-01-04T00:53:45",
"upload_time_iso_8601": "2023-01-04T00:53:45.471123Z",
"url": "https://files.pythonhosted.org/packages/83/44/3700e3d9e65390d55a84d9fac9fbc2c7b38b5078e1dbaea8ff043a43c6b1/luxai2022-1.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-04 00:53:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "Lux-AI-Challenge",
"github_project": "Lux-Design-2022",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "luxai2022"
}
JSON
