可编程虚拟足球

最好的
代码获胜。

编写你球队的大脑——球员、战术与教练——在确定性模拟器中参赛,可在本机或在线平台运行。逻辑由你编写;如果愿意,可交给 AI 来驾驭。

$git clone github.com/GoNNoTDa/PyLeague
AI 可选 · 兼容
Claude OpenAI Gemini Bedrock Groq Mistral DeepSeek Ollama (本地)
两种上手方式

从想法到球场,只需 30 秒

选择你的路径:无需安装即可在线参赛,或克隆 SDK 在本地开发。两者使用相同的确定性引擎。

在线 · 免安装

创建账户、保存球队,在浏览器中进行比赛与联赛。今天上手最快的方式。

免费注册

本地 SDK · 按你的节奏

克隆项目(仅需 Python 3.13,无依赖),复制模板,在本机参赛。

$ git clone github.com/GoNNoTDa/PyLeague
工作原理

公正裁判之上的三层大脑

你不是移动球员,而是编写他们如何决策。引擎对所有人一视同仁且具确定性——相同的 seed,相同的比赛。AI 以较慢的节奏决策;一个确定性层在每个 tick 执行,因此模型无需每秒思考 20 次。

10

教练

读取比分与时间,设定心态:进攻、均衡或防守。

节奏
6

战术

布置球队:防线高度、宽度、逼抢与进攻边路。

节奏
9

球员

每个 tick 做决定:移动、传球或射门。快速而灵敏。

每个tick
功能

已经上场的功能

一个可用的原型,不吹嘘:如今即可运行。

确定性引擎

向量物理与清晰规则。相同的 seed 会重现完全相同的比赛:公平且可调试的竞赛。

多提供商 AI

教练和战术由大模型驱动——它已经在 Gemini 上进行真实比赛。用一个环境变量即可切换提供商(Gemini、Claude、OpenAI、Amazon Bedrock、Ollama…)。

体力与冲刺

每名球员都要管理体力:冲刺和大力射门会消耗体力;没有体力时跑动和射门都会变差。这是你战术中需要编程的又一层面。

联赛与 ELO 排名

让所有球队相互对阵,生成含积分与 ELO 的排行榜,以及可分享的 HTML 报告。

每场比赛统计

控球率、射门与射正、传球与成功率、抢断与跑动距离。你知道要改进什么,而不只是比分。

陪练以迭代

在多个 seed 下让你的球队对阵多个对手,获得胜率与平均值。用数据而非直觉来比较改动。

隔离沙箱

第三方代码在子进程中运行,有时间限制且无网络与磁盘访问:与他人球队竞赛也安全。

战术库

Tiki-taka、链式防守、防守反击、高位逼抢……可直接调整的模板。

回放播放器

每场比赛都像转播一样回放:约 60 fps 的球场、电视风格记分牌、数据统计与 AI 解说。

纯 Python,无依赖

引擎仅使用标准库。AI 的 SDK 为可选。复制模板,几分钟即可上手。

真实代码

几行代码写出一套响应式战术

你设定四个旋钮——防线、宽度、逼抢与重心——可为固定值或随比赛而变。引擎会把它们转化为站位。

mi_tactica.py
from aicup.tactics import TacticalStrategy, progress, possession

def contraataque():
    # 无球时收缩防守;抢回后立即压上。
    def mandos(ctx):
        defendiendo = possession(ctx) == "theirs" or progress(ctx) < 0.45
        if defendiendo:
            return {"line_height": 0.30, "pressing": 0.35}
        return {"line_height": 0.74, "pressing": 0.50}
    return TacticalStrategy("Contraataque", mandos)
在线参赛

上传你的球队,与所有人较量

除了本地 SDK,还有一个 网页平台:创建账户、保存球队,在浏览器中进行比赛与联赛,无需安装任何东西。每场比赛都在服务器上隔离运行并保存回放。

全球 ELO 排名

每支球队通过注册球队之间的比赛累积 ELO 与战绩。在公开排行榜上攀升。

开放竞技场

任何人都可报名参赛的竞赛。一键加入,由组织者开赛。

公开主页

你的主页,展示你的球队、最高 ELO、战绩与回放。你的历程,一目了然。

可验证审计 · 有奖赛事

对每场官方比赛,我们都会保存各球队的确切代码(附 SHA-256)、随机种子与引擎版本。由于引擎具确定性,任何人都能重现比赛并核实结果——无需信任任何人。在联赛中,每场对阵都逐一接受审计。

可分享回放

为任意比赛生成公开链接,无需账户即可观看或审计。下载代码与回放,亲自核实。

带赛制与模板的联赛

用现成模板创建联赛:金属分级(从铁到钻石)、按国家或大洲,或完全自定义。你选择赛制——时长、进球上限、突然死亡——所有对阵都会继承。

邀请他人并分享你的联赛

在组织比赛吗?生成订阅链接,任何人都能报名自己的球队——即使联赛不是开放的——还能按用户名直接邀请平台用户。

战术版本与统计

保存球队的多个版本、为其打标签,并选择每个联赛使用哪个版本,而不改动你的默认战术。对手的战术默认隐藏,除非他选择展示。每支球队都有自己的战绩记录与统计。

SDK

三步,从零到参赛

PyLeague 是一个 SDK:你复制一个已经能好好踢球的模板,把它变成自己的,并通过迭代不断改进。全部本地运行、确定性、无依赖。第一次?先去学院学习如何一步步编写你的球队,或查看仓库里的完整指南

01

克隆项目

只需 Python 3.13 或更高版本。引擎没有任何外部依赖。

$ git clone github.com/GoNNoTDa/PyLeague
02

复制模板

你的球队是一个含三层的文件夹:教练、战术与球员。从标记处开始,每次只改一处。

$ cp -r equipos/plantilla equipos/miequipo
03

衡量、改进并参赛

比赛并在带统计的播放器中观看。用 陪练 一次性衡量你的球队对阵多个对手,并搭建含排行榜与 ELO 的联赛。

$ python play.py --home equipos/miequipo --away equipos/algoritmos
$ python sparring.py --team equipos/miequipo
$ python league.py
适合谁

一个把代码与竞赛结合起来的联赛

编程不再是单打独斗的练习,而成为一场比赛。适合:

开发者社区

GDG、聚会与协会:一个引人入胜的挑战,足以支撑多场活动。

黑客松与挑战

结果明确的竞赛形式:赢的是最好的代码,而非最好的演讲。

教学

高校与训练营:在争胜的比赛中教授逻辑、AI 与数据结构。

企业

以贴合你品牌的内部联赛开展技术团建与雇主品牌建设。

方案

免费畅玩。盛大举办。

SDK 现在与将来都是开源的。如果你想为自己的活动举办一场比赛,我们提供一站式筹办。

用于游玩与学习

开源

0 € / 永久
  • 完整的引擎、SDK 与文档
  • 每场比赛统计与陪练
  • 联赛、ELO 排名与回放播放器
  • 在线平台:账户、全球排名与竞技场
  • 可分享回放与可验证审计
  • 可选多提供商 AI · 使用并修改它
免费注册
用于你的活动

定制赛事

定制
  • 一站式赛事筹办
  • 你的品牌出现在播放器与场边广告牌上
  • 规则、赛程与排名皆可定制
  • 活动期间的支持
联系我们
未来规划

即将到来

路线图上的构想。它们尚未实现——我们讲出来,是为了表明联赛的方向,而不是兜售尚不存在的东西。

即将

杯赛与淘汰赛

带对阵图的淘汰赛制,作为循环联赛之外的补充。

即将

球员级 AI

球员按位置执行的指令,作为教练与战术之外的补充。

探索中

完整规则

边线球与角球、越位与犯规。

探索中

战术副驾

用自然语言描述你的方案,即可转换为代码。

探索中

认知 VAR

一个复核争议判罚的 AI 裁判。

探索中

强化隔离

每场比赛使用容器/虚拟机,以大规模开放公共运行。

常见问题

大家常问的问题

PyLeague 是什么?

一项虚拟足球竞赛,你不是用脚踢球,而是用代码:用 Python 编写每名球员的大脑、球队战术与教练决策,并在确定性模拟器中参赛。

我需要很懂 Python 吗?

不需要。复制内置模板——它已经能有竞争力地比赛——然后逐层改进。具备基础 Python 知识,几分钟即可上手。

免费吗?

是的。PyLeague 开源,你可以免费使用、修改并参赛。我们仅提供可选的定制赛事筹办服务。

玩它需要 AI 密钥吗?

不需要。引擎与示例球队无需任何 API 即可运行。AI 为可选:若想让教练或战术借助语言模型思考,可接入你喜欢的提供商(Claude、OpenAI、Gemini、Groq、Mistral、DeepSeek 或本地的 Ollama)。

我可以为我的活动或社区举办比赛吗?

可以。PyLeague 适合黑客松、开发者社区、教学与各类活动。联系我们,我们为你搭建定制比赛。

它在哪些系统上运行?

Windows、macOS 与 Linux。引擎只需 Python 3.13 或更高版本,且无外部依赖。

我可以在线参赛而无需安装任何东西吗?

可以。在在线平台上创建账户、保存球队,并在浏览器中进行比赛与联赛。每场比赛都在服务器上隔离运行并保存回放,配有全球 ELO 排名、公开主页以及人人可参赛的开放竞技场。

我如何确信有奖赛事是公平的?

因为每场官方比赛都可重现:我们保存各球队的确切代码及其 SHA-256、随机种子与引擎版本。由于引擎具确定性,任何人都可下载全部内容并重现比赛,以核实结果合法,无需信任任何人。在联赛中,每场对阵都逐一接受审计。

品牌与赞助商

把你的品牌放在人才聚集之处

PyLeague 汇聚以代码竞技的开发者:一个难以触达的群体,处于积极的情境中——学习与获胜。与一个公平且可验证的联赛携手,趁你还是最早一批时加入。

你难以触达的受众

在开发者与学生进行创作和竞技时触达这些技术人群。非常适合人才招募与雇主品牌建设。

实打实的曝光

你的品牌出现在转播式播放器、场边广告牌与模拟消息中——以及每一段被分享出去的回放里。

量身定制的形式

你所在社区或高校的联赛、黑客松挑战,或企业内部联赛。规模由你决定。

可验证的信任 · 无可置疑的奖赛

每场官方比赛都可审计、可重现:保存代码、随机种子与引擎版本。一个严谨的有奖赛事,可放心地与你的品牌绑定,无损声誉。

创始品牌

目前尚无赞助商:你可以成为第一个。为最先加入者提供醒目位置与贴心合作。

你的品牌
你的品牌
你的品牌
你的品牌

示例:你的广告牌出现在场边以及每场比赛的播放器中。

开始游玩

组建你的球队。
让代码来决定。

创建账户,几分钟即可在线参赛;或克隆项目在本地游玩。基础模式无需 API 与任何配置即可运行。

$python play.py  ·  python sparring.py  ·  python league.py