jobs-actions Dispatcher

jobs-actions Dispatcher

接收 GitHub Actions 的 workflow_job webhook，并启动 Hugging Face Jobs 来运行它们，适合想让 GitHub 工作流在 Hugging Face 上运行的开发者。

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

简介

它是什么：jobs-actions Dispatcher 是一个让 GitHub Actions 在 Hugging Face Jobs 上运行的项目的调度那一半。GitHub 的 workflow_job 事件会以 webhook 的形式送达，每一个都会让 Space 启动一个 Hugging Face Job。它作为 Docker Space 在 7860 端口运行，由 Python 文件和一个 Dockerfile 构成。

适合谁：适合把代码放在 GitHub 上、想让 Actions 工作流以 Hugging Face Jobs 的形式运行的开发者。已经在用 GitHub App，并且能提供带写权限的 Hugging Face 令牌的人最合适。

行业 | 谁在用 | 怎么用 | 例子
软件开发 | 使用 GitHub Actions 的团队 | 把 GitHub App 的 webhook 指向这个 Space | 工作流任务作为 Hugging Face Jobs 启动
机器学习 | 机器学习工程师 | 通过 Space 变量选择 CPU 或 GPU 运行镜像 | 把需要 GPU 的任务送到 GPU 镜像
运维 | 平台工程师 | 用健康检查端点检查这个 Space | 调用健康检查，确认 Space 还活着

如果你的工作流在 GitHub 自带的运行器上跑得很好，而且没有要连接的 GitHub App，可以跳过它。

用在哪里：这个调度器位于 GitHub 和 Hugging Face 之间。

• GitHub Actions：它响应的是 workflow_job 事件
• GitHub App：它的 webhook 指向这个 Space
• Hugging Face Spaces：它作为 Docker Space 运行在 cpu-upgrade 硬件上
• Windows、macOS 或 Linux 上的 Docker：在本地运行这个 Space 的一份副本

用途 | 谁用 | 能得到什么
在 Hugging Face 上运行工作流任务 | GitHub 上的团队 | 每个 workflow_job webhook 都会启动一个 Hugging Face Job
找到 webhook URL | 设置 GitHub App 的人 | 一个显示这个 Space 的 webhook URL 的落地页
检查它是否在运行 | 运维人员 | 健康检查端点的一次回复

如何设置：你先要准备几个账号和密钥，然后在 Space 上填几项设置。

• 一个 GitHub App，以及它的 App ID、私钥和 webhook 密钥
• 一个带写权限的 Hugging Face 令牌
• 用来运行 Space 的 Hugging Face 账号，或者本地副本用的 Docker
• Python，如果你用 hf 命令下载文件

1. 在 Hugging Face 上运行这个 Space，或者用 Docker 构建一份副本。
2. 在 Space 的设置里，Variables and secrets 下，添加表里的三个密钥。
3. 添加 GH_APP_ID 变量，再按需添加可选变量。
4. 在浏览器里访问这个 Space，读一下它显示的 webhook URL，然后把这个 URL 填进你的 GitHub App。
5. 想要本地副本，就下载文件，构建镜像，并用下面的命令启动容器。

名称 | 类型 | 内容
GH_APP_PRIVATE_KEY | 密钥 | PEM 格式的 GitHub App 私钥，换行要经过编码
GH_WEBHOOK_SECRET | 密钥 | 给 webhook 签名的密钥，在你的 GitHub App 设置里选定
HF_TOKEN | 密钥 | 一个能写入的 Hugging Face 令牌，让 Space 可以启动 Jobs
GH_APP_ID | 变量 | 你的 GitHub App ID，一个数字
HF_NAMESPACE | 变量，可选 | 启动并支付任务费用的用户或组织，默认是 Space 的所有者
RUNNER_IMAGE_CPU | 变量，可选 | CPU 任务用的 Docker 镜像
RUNNER_IMAGE_GPU | 变量，可选 | GPU 任务用的 Docker 镜像
JOB_TIMEOUT | 变量，可选 | 每个任务的默认超时，比如 1h

pip install -U huggingface_hub
hf download huggingface/jobs-actions-dispatcher --repo-type space --local-dir jobs-actions-dispatcher
cd jobs-actions-dispatcher
docker build -t jobs-actions-dispatcher .
docker run -it -p 7860:7860 jobs-actions-dispatcher

如何使用：在 GitHub App 上设好 webhook URL 之后，手动要做的事不多。GitHub 把事件发给 Space，Space 来启动 Jobs。本地副本用下面这条命令启动容器并开放 7860 端口。

docker run -it -p 7860:7860 jobs-actions-dispatcher

工具 | 作用
GET / | 提供一个页面，告诉你该把哪个 webhook URL 交给 GitHub
GET /healthz | 响应存活探测
POST /webhook | 接收带 HMAC 签名的 GitHub App webhook

示例：在一个使用你的 GitHub App 的仓库里，GitHub 上排上了一个工作流任务。GitHub 向 Space 发送 workflow_job webhook，Space 启动一个 Hugging Face Job 来运行它。

新手与专家：如果你是新手，可以把它想成一个中转站。GitHub 说有个任务在等，这个 Space 就请 Hugging Face 去运行它。第一件小事，是在浏览器里打开 Space，读一读它的落地页。

如果你熟悉这个领域，这个 Space 是 webhook 的接收和启动方，另一半负责运行器。仓库按 GitHub App、Jobs 调用和运行器引导把工作分到不同文件里。代价是 Space 需要带写权限的令牌和 GitHub App 私钥。

GitHub 排上一个工作流任务
GitHub 发送带签名的 webhook
Space 启动一个 Hugging Face Job
Job 运行这个工作流

注意事项：它只是调度器，所以要配合运行器那一半和一个 GitHub App 才有用。

• Hardware: Hugging Face 上的 cpu-upgrade，端口 7860
• Size: 仓库里有 16 个文件
• License: apache-2
• Cost to run: 一个带写权限的 Hugging Face 令牌，一个 GitHub App，以及记在你所设命名空间下的 Hugging Face Jobs 费用
• Data it reaches: GitHub webhook，GitHub App 私钥，以及启动 Jobs 的 Hugging Face 账号
• Not for: 没有提到禁止的用途

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

• 点赞：3
• 构建方式：docker
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/huggingface/jobs-actions-dispatcher
• 文件：https://huggingface.co/spaces/huggingface/jobs-actions-dispatcher/tree/main

试用

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