[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Lux-AI-Challenge--Lux-Design-S1":3,"tool-Lux-AI-Challenge--Lux-Design-S1":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":80,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":123,"forks":124,"last_commit_at":125,"license":126,"difficulty_score":23,"env_os":127,"env_gpu":128,"env_ram":128,"env_deps":129,"category_tags":135,"github_topics":136,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":143,"updated_at":144,"faqs":145,"releases":161},3494,"Lux-AI-Challenge\u002FLux-Design-S1","Lux-Design-S1","Home to the design and engine of the @Lux-AI-Challenge Season 1, hosted on @kaggle","Lux-Design-S1 是专为\"Lux AI 挑战赛第一季”打造的开源游戏引擎与设计框架，托管于 Kaggle 平台。它构建了一个充满策略性的虚拟战场：两支智能体队伍需在昼夜交替的环境中对抗黑暗、采集资源并跨越时代发展。白天需争分夺秒地建设与储备，夜晚则依赖城市产生的光芒生存，任何光照不足的城市都将被黑暗吞噬。\n\n该工具核心解决的是多变量优化、资源分配及实时博弈问题。使用者不仅要设计高效的资源管理算法，还需让智能体具备分析对手策略并动态调整战术的能力，从而在 1v1 对抗中占据上风。\n\nLux-Design-S1 非常适合开发者、人工智能研究人员以及编程爱好者使用。无论是希望锻炼强化学习算法的专家，还是想要入门多智能体博弈的学生，都能在此找到实践场景。其技术亮点在于提供了完善的跨语言启动套件（涵盖 Python 等主流语言），支持通过命令行或 Docker 便捷地运行本地比赛、生成可视化回放并进行错误日志分析。此外，项目基于 Dimensions 包构建，拥有清晰的规则文档与活跃的社区支持，帮助用户快速上手并专注于核心算法的创新与迭代。","# Lux AI Challenge: Season 1\n\nThe night is dark and full of terrors. Two teams must fight off the darkness, collect resources, and advance through the ages. Daytime finds a desperate rush to gather and build the resources that can carry you through the impending night. Plan and expand carefully -- any city that fails to produce enough light will be consumed by darkness.\n\nWelcome to the Lux AI Challenge Season 1!\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLux-AI-Challenge_Lux-Design-S1_readme_0910c444dd92.gif\" style=\"width:50%\" \u002F>\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\nTo get started, go to our [Getting Started](#getting-started) section. The competition runs until December 6th 2021 and submissions are due at 11:59PM UTC on the competition page: https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Flux-ai-2021\n\nThanks to our sponsors [QuantCo](https:\u002F\u002Fquantco.com\u002F), [J Ventures](http:\u002F\u002Fwww.thejiangmen.com\u002F), and [QAImera](https:\u002F\u002Fqaimera.com), we have a $10,000 prize pool along with many other non-monetary prizes this year! For more information see https:\u002F\u002Fwww.lux-ai.org\u002Fsponsors-2021\n\nMake sure to join our community discord at https:\u002F\u002Fdiscord.gg\u002FaWJt3UAcgn to chat, strategize, and learn with other competitors! We will be posting announcements on the Kaggle Forums and on the discord.\n\nThis was built by the Lux AI Challenge team, using the [Dimensions](https:\u002F\u002Fgithub.com\u002FStoneT2000\u002FDimensions) package.\n\nSeason 1 specifications can be found here: https:\u002F\u002Flux-ai.org\u002Fspecs-2021. These detail how the game works and what rules your agent must abide by.\n\n## Getting Started\n\nYou will need Node.js version 12 or above. See installation instructions [here](https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload\u002F), you can just download the recommended version.\n\nThe next parts detail the recommended setup to develop and compete your bot. For users who wish to use Python and Jupyter Notebooks \u002F Kaggle Interactive Notebooks, feel free to skip this section and follow the [tutorial notebook](https:\u002F\u002Fwww.kaggle.com\u002Fstonet2000\u002Flux-ai-season-1-jupyter-notebook-tutorial)\n\nOpen up the command line, and install the competition design with\n\n```\nnpm install -g @lux-ai\u002F2021-challenge@latest\n```\n\nYou may ignore any warnings that show up, those are harmless. To run a match from the command line (CLI), simply run\n\n```\nlux-ai-2021 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n```\n\nand the match will run with some logging and store error logs and a replay in a new `errorlogs` folder and `replays` folder. Logs stored in the errorlogs will include all error output and anything printed to standard error by your agent. You can watch the replay stored in the replays folder using our [visualizer](https:\u002F\u002F2021vis.lux-ai.org\u002F). To watch the replay locally, follow instructions here https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLuxViewer2021\u002F\n\nFor a full list of commands from the CLI, run\n\n```\nlux-ai-2021 --help\n```\n\nor go to the [next section](#CLI-Usage) to see more instructions on how to use the command line tool, including generating stateful replays and running local leaderboards for evaluation. You may also run this all in docker using the `cli.sh` file in this repo, see instructions [here](#cli-docker).\n\nEach programming language has a starter kit, you can find general API documentation here: https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\n\nThe [kits](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits) folder in this repository holds all of the available starter kits you can use to start competing and building an AI agent and show you how to get started with your language of choice and run a match with that bot can be found. **We strongly recommend reading through the documentation for your language of choice** in the links below\n\n- [Python](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fpython)\n- [Javascript](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fjs)\n- [Rust](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Frust) (maintained by [@tye-singwa](https:\u002F\u002Fgithub.com\u002Ftye-singwa))\n- [C++](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fcpp)\n- [Java](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fjava)\n- [Typescript](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fts)\n- [Kotlin](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fkotlin) (maintained by [@Tolsi](https:\u002F\u002Fgithub.com\u002FTolsi))\n\nThere are also many [community provided tools](#Community-Tools) to help people build better bots, feel free to check those out and use whatever suits your needs\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 document](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Fblob\u002Fmaster\u002FCONTRIBUTING.md) 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](https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Fhungry-geese\u002Fdiscussion) or the [Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FDZSm47VHMz). See https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Fblob\u002Fmaster\u002FChangeLog.md for a full change log.\n\n## CLI Usage\n\n\n### CLI General \nThe CLI tool has several options. For example, one option is the seed and to set a seed of 100 simply run\n\n```\nlux-ai-2021 --seed=100 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n```\n\nwhich will run a match using seed 100.\n\nYou can tell the CLI tool whether to store the agent logs or match replays via `--storeLogs, --storeReplay`. Set these boolean options like so\n\n```\n# to set to true\nlux-ai-2021 --statefulReplay\n# to set to false\nlux-ai-2021 --storeLogs=false\n```\n\nBy default the tool will generate minimum, **action-based**, replays that are small in size and work in the visualizer but it does not have state information e.g. resources on the map in each turn. To generate **stateful** replays, set the `--statefulReplay` option to true. To convert a action-based replay to a stateful one, set the `--convertToStateful` option to true and pass the file to convert.\n\nChoose where the replay file is stored at by setting `--out=path\u002Fto\u002Ffile.json`\n\nYou can also change the logging levels by setting `--loglevel=x` for number x from 0 to 4. The default is 2 which will print to terminal all game warnings and errors.\n\n### CLI Leaderboard Evaluation\n\nYou can run your own local leaderboard \u002F tournament to evaluate several bots at once via\n\n```\nlux-ai-2021 --rankSystem=\"trueskill\" --tournament path\u002Fto\u002Fagent1 path\u002Fto\u002Fagent2 path\u002Fto\u002Fagent3 path\u002Fto\u002Fagent4 ...\n```\n\nThis will run a leaderboard ranked by trueskill and print results as a table to your console. Agents are auto matched with opponents with similar ratings. Recommended to add `--storeReplay=false --storeLogs=false` as letting this run for a long time will generate a lot of replays and log files.\n\nSee `lux-ai-2021 --help` for more options.\n\n### CLI Docker\n\nThis tool matches the lux-ai-2021 exactly, but runs on Ubuntu 18.04, the target system that the competition servers use. Make sure to first [install docker](https:\u002F\u002Fdocs.docker.com\u002Fget-docker\u002F)\n\nTo then use the lux-ai-2021 CLI tool, simply call `bash cli.sh` and it will accept the same exact arguments. On the first run, it will build a docker image and run a container in the background. Future runs will then be much faster. Moreover, this uses a bind mount, so you can edit files locally on your computer and they will be reflected in the docker container and vice versa. \n\nThe only caveat of this tool is that it has no access to files in directories above the current working directory (the output of the `pwd` command).\n\nMoreover, this tool will not inherit the same installed python packages on your computer. To add packages, please download the Dockerfile from this repo into the same directory as the `cli.sh` file and add installation commands like so to the bottom of the file\n\n```docker\nRUN pip3 install \u003Cpackage_name>\n```\n\nAfter changing the Dockerfile, run `bash cli.sh clean` to clean the old docker stuff and then use `cli.sh` as usual.\n\n## Community-Tools\n\nThis is a list of all community tools built by our community!\n\n- [Lux AI Python Gym](https:\u002F\u002Fgithub.com\u002Fglmcdona\u002FLuxPythonEnvGym\u002F): A OpenAI compliant gym that replicates the entire Lux AI 2021 design. About 45x faster than the official environment for python agents and makes it easier to try more ML \u002F search heavy approaches to the competition, maintained by [glmcdona](https:\u002F\u002Fgithub.com\u002Fglmcdona\u002F)\n- [Optics](https:\u002F\u002Fgithub.com\u002Frooklift\u002Foptics): A simple, fast, top-down-view visualizer by [rooklift](https:\u002F\u002Fgithub.com\u002Frooklift\u002F)\n- [Command Line Visualizer](https:\u002F\u002Fgithub.com\u002Fnathanbabcock\u002Flux-ai-vis): A streamlined tool to watch a replay by running a single command in the CLI\n- [Public Notebooks](https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Flux-ai-2021\u002Fcode): A collection of all public notebooks (in python usually) where competitors share their ideas, code, and more. There are all kinds of solutions here, from RL, Imitation Learning, to rule based approaches.\n- [Submission Statistics](https:\u002F\u002Flux-ai-stats.herokuapp.com\u002F): A tool to track any submission to the competition, showing score change over time, wins and losses etc.\n\n\n## Contributing\n\nSee the [guide on contributing](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002FCONTRIBUTING.md)\n\n## Authors\n\nOriginal design for season 1 concevied by [Bovard](https:\u002F\u002Fgithub.com\u002Fbovard) and [Stone](https:\u002F\u002Fgithub.com\u002FStoneT2000)\n\nUI\u002FUX Design by [Isa](https:\u002F\u002Fgithub.com\u002Fp-isa)\n\nWith balance testing help from [David](https:\u002F\u002Fgithub.com\u002Fholypegasus)\n\n## Sponsors\nWe would like to thank our 3 sponsors, [QuantCo](https:\u002F\u002Fquantco.com\u002F), [J Ventures](http:\u002F\u002Fwww.thejiangmen.com\u002F), and [QAImera](https:\u002F\u002Fqaimera.com) this year for allowing us to provide a prize pool and exciting opportunities to our competitors! For more information on them, check them out here: https:\u002F\u002Fwww.lux-ai.org\u002Fsponsors-2021\n\n## Citation\n\nIf you use the Lux AI Season 1 environment in your work, please cite this repository as so\n\n```\n@software{Lux_AI_Challenge_S1,\n  author = {Doerschuk-Tiberi, Bovard and Tao, Stone},\n  month = {7},\n  title = {{Lux AI Challenge Season 1}},\n  url = {https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021},\n  version = {1.0.0},\n  year = {2021}\n}\n```\n","# Lux AI 挑战赛：第 1 季\n\n黑夜漫长而充满恐惧。两支队伍必须对抗黑暗，收集资源，并穿越各个时代。白昼则是争分夺秒地搜集和建造能够帮助你熬过即将到来的夜晚的资源。请谨慎规划与扩张——任何无法产生足够光芒的城市都将被黑暗吞噬。\n\n欢迎来到 Lux AI 挑战赛第 1 季！\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLux-AI-Challenge_Lux-Design-S1_readme_0910c444dd92.gif\" style=\"width:50%\" \u002F>\n\nLux AI 挑战赛是一项竞赛，参赛者需要设计智能体，在一对一的对抗场景中解决多变量优化、资源采集与分配的问题。除了优化能力之外，成功的智能体还必须能够分析对手，并制定相应的策略以取得优势。\n\n要开始，请前往我们的 [入门指南](#getting-started) 部分。比赛将持续到 2021 年 12 月 6 日，提交截止时间为 UTC 时间晚上 11:59，提交地址为：https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Flux-ai-2021\n\n感谢我们的赞助商 [QuantCo](https:\u002F\u002Fquantco.com\u002F)、[J Ventures](http:\u002F\u002Fwww.thejiangmen.com\u002F) 和 [QAImera](https:\u002F\u002Fqaimera.com\u002F)，今年我们设立了 1 万美元的奖金池，以及众多非现金奖品！更多信息请访问：https:\u002F\u002Fwww.lux-ai.org\u002Fsponsors-2021\n\n请务必加入我们的社区 Discord 群组：https:\u002F\u002Fdiscord.gg\u002FaWJt3UAcgn，与其他参赛者交流、制定策略并互相学习！我们将在 Kaggle 论坛和 Discord 上发布相关公告。\n\n本项目由 Lux AI 挑战赛团队使用 [Dimensions](https:\u002F\u002Fgithub.com\u002FStoneT2000\u002FDimensions) 工具包构建。\n\n第 1 季的规则说明可在此查阅：https:\u002F\u002Flux-ai.org\u002Fspecs-2021。其中详细介绍了游戏机制及智能体需遵守的规则。\n\n## 入门指南\n\n您需要安装 Node.js 12 或更高版本。安装说明请参见 [这里](https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload\u002F)，直接下载推荐版本即可。\n\n接下来的部分将详细介绍开发和参赛机器人的推荐设置。如果您希望使用 Python 和 Jupyter Notebook \u002F Kaggle Interactive Notebook，可以跳过本节，直接参考 [教程笔记本](https:\u002F\u002Fwww.kaggle.com\u002Fstonet2000\u002Flux-ai-season-1-jupyter-notebook-tutorial)。\n\n打开命令行，通过以下命令安装比赛框架：\n\n```\nnpm install -g @lux-ai\u002F2021-challenge@latest\n```\n\n您可以忽略出现的任何警告，这些警告并无影响。要在命令行（CLI）中运行一场比赛，只需执行：\n\n```\nlux-ai-2021 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n```\n\n系统将运行比赛并记录日志，同时将错误日志和对局回放保存在新创建的 `errorlogs` 文件夹和 `replays` 文件夹中。`errorlogs` 文件夹中的日志包含所有错误输出以及您的智能体打印到标准错误流的内容。您可以通过我们的 [可视化工具](https:\u002F\u002F2021vis.lux-ai.org\u002F) 观看 `replays` 文件夹中的回放。如需在本地观看回放，请按照此处说明操作：https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLuxViewer2021\u002F\n\n如需查看 CLI 的完整命令列表，运行：\n\n```\nlux-ai-2021 --help\n```\n\n或前往 [下一节](#CLI-Usage)，了解更多关于如何使用命令行工具的说明，包括生成带状态信息的回放以及运行本地排行榜进行评估。您也可以使用本仓库中的 `cli.sh` 脚本在 Docker 容器中运行所有操作，具体说明请参见 [这里](#cli-docker)。\n\n每种编程语言都提供了 starter kit，通用 API 文档可在以下链接找到：https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\n\n此仓库中的 [kits](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits) 文件夹包含了所有可用的 starter kit，您可以使用它们开始参赛并构建 AI 智能体，了解如何使用您选择的语言启动项目，并用该机器人进行对局。**我们强烈建议您阅读所选语言的相关文档**，链接如下：\n\n- [Python](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fpython)\n- [JavaScript](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fjs)\n- [Rust](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Frust)（由 [@tye-singwa](https:\u002F\u002Fgithub.com\u002Ftye-singwa) 维护）\n- [C++](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fcpp)\n- [Java](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fjava)\n- [TypeScript](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fts)\n- [Kotlin](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits\u002Fkotlin)（由 [@Tolsi](https:\u002F\u002Fgithub.com\u002FTolsi) 维护）\n\n此外，还有许多 [社区提供的工具](#Community-Tools)，可以帮助大家打造更优秀的机器人，请随意查看并根据需求选用。\n\n想使用其他语言但尚未支持？欢迎在我们的问题页面提出建议，或者更好的是，为社区创建一个 starter kit，并向本仓库提交 Pull Request。更多相关信息请参阅我们的 [CONTRIBUTING.md 文档](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Fblob\u002Fmaster\u002FCONTRIBUTING.md)。\n\n要随时了解比赛和引擎的最新动态与更新，请关注 [论坛](https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Fhungry-geese\u002Fdiscussion) 或 [Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FDZSm47VHMz) 上的通知。完整的变更日志请参阅：https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Fblob\u002Fmaster\u002FChangeLog.md。\n\n## CLI 使用说明\n\n\n### CLI 常规选项\nCLI 工具提供多种选项。例如，您可以设置随机数种子，只需运行：\n\n```\nlux-ai-2021 --seed=100 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n```\n\n即可使用种子 100 运行一场比赛。\n\n您还可以通过 `--storeLogs` 和 `--storeReplay` 选项控制是否保存智能体日志或对局回放。这些布尔选项的设置方式如下：\n\n```\n# 设置为 true\nlux-ai-2021 --statefulReplay\n# 设置为 false\nlux-ai-2021 --storeLogs=false\n```\n\n默认情况下，工具会生成基于动作的轻量级回放文件，这类回放可以在可视化工具中播放，但不包含每回合的地图状态信息，比如资源数量等。若需生成包含状态信息的回放，请将 `--statefulReplay` 选项设置为 true。若要将基于动作的回放转换为带状态信息的回放，可将 `--convertToStateful` 选项设置为 true，并指定要转换的文件。\n\n您还可以通过 `--out=path\u002Fto\u002Ffile.json` 指定回放文件的保存路径。\n\n此外，您可以通过设置 `--loglevel=x` 来调整日志级别，x 的取值范围为 0 到 4。默认值为 2，此时终端会显示所有游戏警告和错误信息。\n\n### CLI 排行榜评估\n\n您可以通过以下命令在本地运行自己的排行榜或锦标赛，以同时评估多个智能体：\n\n```\nlux-ai-2021 --rankSystem=\"trueskill\" --tournament 路径\u002F到\u002Fagent1 路径\u002F到\u002Fagent2 路径\u002F到\u002Fagent3 路径\u002F到\u002Fagent4 ...\n```\n\n这将运行一个基于 TrueSkill 算法的排行榜，并将结果以表格形式打印到您的控制台。智能体会自动匹配与自己评分相近的对手。建议添加 `--storeReplay=false --storeLogs=false` 参数，因为长时间运行会产生大量的对局回放和日志文件。\n\n更多选项请参阅 `lux-ai-2021 --help`。\n\n### CLI Docker 版本\n\n此工具与 lux-ai-2021 完全一致，但在竞赛服务器所使用的 Ubuntu 18.04 系统上运行。请先 [安装 Docker](https:\u002F\u002Fdocs.docker.com\u002Fget-docker\u002F)。\n\n要使用 lux-ai-2021 的 CLI 工具，只需调用 `bash cli.sh`，它将接受完全相同的参数。首次运行时，它会构建一个 Docker 镜像并在后台启动容器。后续运行将会快得多。此外，该工具使用了绑定挂载，因此您可以在本地编辑文件，这些更改会立即反映到 Docker 容器中，反之亦然。\n\n该工具的唯一限制是无法访问当前工作目录（即 `pwd` 命令输出的目录）以上层级的文件。\n\n另外，该工具不会继承您计算机上已安装的 Python 包。如需添加包，请将此仓库中的 Dockerfile 下载到与 `cli.sh` 文件相同的目录，并在文件末尾添加如下安装命令：\n\n```docker\nRUN pip3 install \u003Cpackage_name>\n```\n\n修改 Dockerfile 后，运行 `bash cli.sh clean` 清理旧的 Docker 相关内容，然后即可正常使用 `cli.sh`。\n\n## 社区工具\n\n以下是社区成员开发的所有工具列表！\n\n- [Lux AI Python Gym](https:\u002F\u002Fgithub.com\u002Fglmcdona\u002FLuxPythonEnvGym\u002F)：一个兼容 OpenAI Gym 的环境，完整复现了 Lux AI 2021 的设计。对于 Python 智能体而言，速度约为官方环境的 45 倍，便于尝试更多机器学习或搜索密集型方法。由 [glmcdona](https:\u002F\u002Fgithub.com\u002Fglmcdona\u002F) 维护。\n- [Optics](https:\u002F\u002Fgithub.com\u002Frooklift\u002Foptics)：一个简单、快速的俯视图可视化工具，由 [rooklift](https:\u002F\u002Fgithub.com\u002Frooklift\u002F) 开发。\n- [命令行可视化工具](https:\u002F\u002Fgithub.com\u002Fnathanbabcock\u002Flux-ai-vis)：通过在命令行中运行单条命令即可观看对局回放的精简工具。\n- [公开笔记本](https:\u002F\u002Fwww.kaggle.com\u002Fc\u002Flux-ai-2021\u002Fcode)：所有公开的竞赛选手分享创意、代码等内容的笔记本集合。这里包含了各种解决方案，从强化学习、模仿学习到基于规则的方法。\n- [提交统计](https:\u002F\u002Flux-ai-stats.herokuapp.com\u002F)：用于跟踪任何参赛提交的工具，可显示分数随时间的变化、胜负情况等。\n\n## 贡献说明\n\n请参阅[贡献指南](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002FCONTRIBUTING.md)。\n\n## 作者\n\n第一赛季的原始设计由 [Bovard](https:\u002F\u002Fgithub.com\u002Fbovard) 和 [Stone](https:\u002F\u002Fgithub.com\u002FStoneT2000) 共同构思。\n\nUI\u002FUX 设计由 [Isa](https:\u002F\u002Fgithub.com\u002Fp-isa) 完成。\n\n平衡性测试得到了 [David](https:\u002F\u002Fgithub.com\u002Fholypegasus) 的协助。\n\n## 赞助商\n\n我们衷心感谢今年的三位赞助商——[QuantCo](https:\u002F\u002Fquantco.com\u002F)、[J Ventures](http:\u002F\u002Fwww.thejiangmen.com\u002F) 和 [QAImera](https:\u002F\u002Fqaimera.com)，正是他们的支持才使得我们能够为参赛者提供丰厚的奖金池和精彩的机会！有关他们的更多信息，请访问：https:\u002F\u002Fwww.lux-ai.org\u002Fsponsors-2021\n\n## 引用\n\n如果您在工作中使用了 Lux AI 第一赛季的环境，请按以下格式引用本仓库：\n\n```\n@software{Lux_AI_Challenge_S1,\n  author = {Doerschuk-Tiberi, Bovard and Tao, Stone},\n  month = {7},\n  title = {{Lux AI Challenge Season 1}},\n  url = {https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021},\n  version = {1.0.0},\n  year = {2021}\n}\n```","# Lux-Design-S1 快速上手指南\n\nLux AI Challenge Season 1 是一个 1v1 的 AI 竞技平台。你需要设计智能体（Agent），在昼夜交替的环境中与对手竞争，完成资源采集、城市建设和光照维持等多目标优化任务。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：Windows, macOS 或 Linux (推荐 Ubuntu 18.04+)\n*   **核心依赖**：必须安装 **Node.js** (版本 12 或以上)。\n    *   下载地址：[https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload\u002F](https:\u002F\u002Fnodejs.org\u002Fen\u002Fdownload\u002F) (建议下载推荐的 LTS 版本)\n*   **编程语言支持**：官方提供 Python, JavaScript, Rust, C++, Java, TypeScript, Kotlin 等多种语言的 starter kit。\n    *   *注：如果你计划使用 Python 并在 Kaggle Notebook 中开发，可跳过 CLI 安装步骤，直接参考官方教程 Notebook。*\n\n## 安装步骤\n\n打开终端（命令行工具），运行以下命令全局安装竞赛引擎：\n\n```bash\nnpm install -g @lux-ai\u002F2021-challenge@latest\n```\n\n> **提示**：安装过程中若出现警告信息（warnings），通常可以忽略，不影响正常使用。\n\n## 基本使用\n\n### 1. 运行比赛\n\n假设你已经准备好了两个智能体文件（例如 `bot1.py` 和 `bot2.py`），在终端中运行以下命令即可开始一局比赛：\n\n```bash\nlux-ai-2021 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n```\n\n**执行结果：**\n*   比赛会在终端输出日志。\n*   错误日志会自动保存在新生成的 `errorlogs` 文件夹中。\n*   比赛回放文件会自动保存在 `replays` 文件夹中。\n\n### 2. 查看回放\n\n你可以使用官方在线可视化工具查看生成的回放文件：\n*   **在线查看**：访问 [https:\u002F\u002F2021vis.lux-ai.org\u002F](https:\u002F\u002F2021vis.lux-ai.org\u002F) 并上传 `replays` 文件夹中的 JSON 文件。\n*   **本地查看**：如需本地部署可视化器，请参考 [LuxViewer2021](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLuxViewer2021\u002F) 项目。\n\n### 3. 进阶选项示例\n\n*   **指定随机种子**（确保复现性）：\n    ```bash\n    lux-ai-2021 --seed=100 path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n    ```\n*   **生成包含状态信息的回放**（默认仅包含动作，开启此选项可记录每回合的资源分布等状态）：\n    ```bash\n    lux-ai-2021 --statefulReplay path\u002Fto\u002Fbotfile path\u002Fto\u002Fotherbotfile\n    ```\n*   **查看完整帮助文档**：\n    ```bash\n    lux-ai-2021 --help\n    ```\n\n### 4. 获取语言模板\n\n前往官方仓库的 `kits` 目录下载对应语言的入门代码包，其中包含了 API 文档和运行示例：\n*   地址：[https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits](https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-2021\u002Ftree\u002Fmaster\u002Fkits)\n*   强烈建议阅读你所选语言的具体文档以了解 API 细节。","某高校 AI 实验室团队正备战 Kaggle 算法竞赛，需要开发一个能在昼夜交替环境中进行资源采集与对抗决策的智能体。\n\n### 没有 Lux-Design-S1 时\n- **环境搭建繁琐**：团队需手动编写游戏引擎逻辑、地图渲染及规则判定代码，耗费数周时间仍难以保证仿真环境的准确性。\n- **调试反馈滞后**：缺乏可视化的复盘工具，智能体在“黑夜”中失败的原因只能靠查阅枯燥的文本日志猜测，难以定位策略漏洞。\n- **多语言协作困难**：队员分别擅长 Python 和 Node.js，但缺少统一的标准化接口（Starter Kits），导致代码整合与对战测试极其麻烦。\n- **评估标准缺失**：无法在本地快速运行大规模模拟赛或生成排行榜，难以客观量化不同策略版本的优劣。\n\n### 使用 Lux-Design-S1 后\n- **开箱即用引擎**：通过一条 npm 命令即可安装包含完整游戏规则与物理引擎的环境，团队当天便开始了核心算法的开发。\n- **可视化精准复盘**：利用内置的 Replay 回放系统与可视化器，队员能直观看到智能体因光照不足被吞噬的全过程，迅速优化资源分配策略。\n- **多语言无缝对接**：借助官方提供的 Python、Node.js 等多语言启动包，不同技术背景的队员可独立开发模块并直接在同一环境中对战验证。\n- **高效本地评估**：通过 CLI 命令行工具轻松运行本地锦标赛并生成误差日志，实现了策略迭代效果的即时量化与对比。\n\nLux-Design-S1 将复杂的博弈环境构建转化为标准化的开发流程，让研究者能专注于核心算法创新而非底层基建。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FLux-AI-Challenge_Lux-Design-S1_0910c444.gif","Lux-AI-Challenge","Lux AI Challenge","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FLux-AI-Challenge_d551c5c9.png","We develop and run creative, accessible, inclusive, and engaging AI programming competitions",null,"hello@lux-ai.org","LuxAIChallenge","https:\u002F\u002Flux-ai.org\u002F","https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge",[85,89,93,97,101,104,108,112,115,119],{"name":86,"color":87,"percentage":88},"Jupyter Notebook","#DA5B0B",54.7,{"name":90,"color":91,"percentage":92},"C++","#f34b7d",36.7,{"name":94,"color":95,"percentage":96},"TypeScript","#3178c6",3.9,{"name":98,"color":99,"percentage":100},"JavaScript","#f1e05a",1.4,{"name":102,"color":103,"percentage":100},"Rust","#dea584",{"name":105,"color":106,"percentage":107},"Python","#3572A5",0.9,{"name":109,"color":110,"percentage":111},"Kotlin","#A97BFF",0.4,{"name":113,"color":114,"percentage":111},"Java","#b07219",{"name":116,"color":117,"percentage":118},"Shell","#89e051",0.2,{"name":120,"color":121,"percentage":122},"PowerShell","#012456",0.1,905,146,"2026-03-24T05:41:01","Apache-2.0","Linux, macOS, Windows","未说明",{"notes":130,"python":131,"dependencies":132},"该工具核心是一个基于 Node.js 的游戏引擎。虽然提供 Python 入门套件，但运行比赛模拟需要安装 Node.js 12 及以上版本。若需完全复现竞赛服务器环境（Ubuntu 18.04），可使用提供的 Docker 方案。社区提供了加速版的 Python Gym 环境用于机器学习训练。","未说明 (官方推荐通过 Jupyter Notebook 运行，底层引擎依赖 Node.js)",[133,134],"Node.js >= 12","@lux-ai\u002F2021-challenge (npm 包)",[14,13,15],[137,138,139,140,141,142],"ai","competition","programming","lux-ai","hacktoberfest","reinforcement-learning","2026-03-27T02:49:30.150509","2026-04-06T07:13:21.516348",[146,151,156],{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},16035,"在 macOS 上运行 CLI 时遇到写入权限错误（EACCES: permission denied）怎么办？","不要全局安装该包。请创建一个新文件夹，在文件夹内运行 `npm install @lux-ai\u002F2021-challenge` 进行本地安装。然后使用 `npx lux-ai-2021` 命令并添加相应参数来运行程序。这样可以避免向系统目录写入文件时的权限问题。","https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-S1\u002Fissues\u002F132",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},16036,"导入包含 `lux\u002Fkit.hpp` 的头文件和 cpp 文件组合时，出现内部文件多重定义错误如何解决？","这是一个常见的 C++ 链接问题。解决方案是将所有静态变量定义移动到 `\u002Flux` 目录下的一个 .cpp 文件中，并在编译命令中包含该 .cpp 文件，确保静态变量只被定义一次。此外，对于头文件中的自由函数、变量或常量，应将 `static` 关键字改为 `inline`，以确保所有源文件共享同一份编译代码而不是各自创建副本。如果可以使用 C++17，也可以在类内部将静态成员定义为 `static inline`。","https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-S1\u002Fissues\u002F56",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},16037,"当多个工人（Worker）位于同一个城市地块（CityTile）上时，资源收集机制是如何工作的？","资源请求是按地块（tile）生成的。如果一个地块已经有一个资源请求，同一地块上的其他单位无法生成更多请求。一旦生成了资源请求，如果请求位置存在城市地块（CityTile），系统将忽略请求中的数量参数，直接将该城市地块视为单个工人进行资源收集。无论有多少工人站在该城市地块上，该地块每回合仅收集相当于一个工人的资源量并转化为燃料。多余的工人不会增加收集速度，但可以将携带的资源存入城市地块转化为燃料。","https:\u002F\u002Fgithub.com\u002FLux-AI-Challenge\u002FLux-Design-S1\u002Fissues\u002F143",[]]