JerseyNet - Jersey Number Detection

JerseyNet - Jersey Number Detection

在图片里找出球衣号码并在每个号码外画框，全程在你的浏览器里完成，图片不会离开你的设备。

由 MHkhan50 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：JerseyNet 是一个小型检测器，能在图片里找出球衣号码，并在每个找到的号码外画一个框。模型通过 ONNX Runtime Web 在你的浏览器里运行，所以图片不会被上传到任何地方。它只定位号码，不识别具体数字。

适合谁：研究体育图像分析的人，或者想看一个紧凑的检测模型完全在浏览器里运行的人。

行业 | 谁在用 | 怎么用 | 例子
体育分析 | 研究者和分析师 | 在比赛照片里定位球衣号码 | 在一张冰球照片里找出号码
计算机视觉 | 学生和开发者 | 研究一个在客户端运行的小型检测器 | 阅读页面如何加载模型文件
教育 | 机器学习老师 | 演示不需要任何服务器的检测 | 展示一个从不上传图片的模型

如果你需要识别具体数字或处理其他运动，可以跳过它，因为作者把它称作研究演示。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 的页面里
• Windows、macOS 或 Linux 上的浏览器，打开下载好的 index.html

使用场景 | 谁用 | 得到什么
在照片里找号码 | 有冰球图片的任何人 | 在找到的每个号码外画的框
试用浏览器内检测 | 开发者 | 一个无需上传就能运行的模型
研究页面代码 | 学生 | 一个带模型文件和两个脚本的小型静态页面

如何设置：在线使用不需要安装任何东西。本地副本需要一个浏览器，以及下载时用到的少量 Python。

• 一个网页浏览器
• Python 和 pip 工具，只在下载这一步需要

1. 用 pip 安装 Hugging Face hub 包。
2. 把这个 Space 的文件下载到一个文件夹里。
3. 进入该文件夹。
4. 在网页浏览器里打开 index.html。

pip install -U huggingface_hub
hf download MHkhan50/jersey-number-detection --repo-type space --local-dir jersey-number-detection
cd jersey-number-detection

如何使用：打开这个 Space 的页面，或打开本地副本里的 index.html，然后上传一张图片。页面会在它找到的每个球衣号码外画一个框。来源没有列出其他控件。

hf download MHkhan50/jersey-number-detection --repo-type space --local-dir jersey-number-detection

示例：你上传一张冰球比赛的照片，其中一名球员的号码清晰可见。页面会在这个号码外画一个框。它不会告诉你具体是哪些数字，而画面拥挤或尺寸很大的照片可能效果较差。

新手与专家：检测就是找出东西在图片里的位置。第一步，上传一张清晰的冰球照片，看看那些框。所有内容都不会离开你的浏览器。

这个模型叫 JerseyNet，是一个 CenterNet 风格、4.7M 参数的检测器，在公开的 jersey-2 数据集上从随机初始化开始训练，用了 mosaic 增强、GIoU 框损失和 384 px 输入。在测试集上，它的 AP50:95 为 0.314，AP50 为 0.593，三个随机种子的平均值为 0.308。页面按训练时的方式做 letterbox 并解码热力图，导出的流程与 Python 的结果一致。

在浏览器里上传一张图片
图片被 letterbox 成模型输入
ONNX Runtime Web 在本地运行 JerseyNet
在号码外画框

注意事项：

• Limits: 它只用小尺寸冰球图片训练，所以对号码清晰的冰球照片效果最好，对其他运动、大尺寸照片和拥挤场景则较弱
• License: MIT
• Cost to run: 来源没有提到
• Data it reaches: 你的图片留在浏览器里，页面会从仓库加载 jerseynet.onnx 模型文件
• Not for: 识别数字、其他运动或生产环境使用，因为它是研究演示

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：static
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/MHkhan50/jersey-number-detection
• 文件：https://huggingface.co/spaces/MHkhan50/jersey-number-detection/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。