huggingface/jobs-actions-dispatcher

Space

1

stars

25

commits

1

linked in READMEs

Jun 5, 2026

updated

docker

README

jobs-actions Dispatcher

This Space is the dispatcher half of jobs-actions: it receives GitHub Actions workflow_job webhooks and launches HF Jobs to execute them.

Open the Space in a browser to see the GitHub App webhook URL for this Space. It will look like:

https://YOUR-SPACE-SUBDOMAIN.hf.space/webhook

Configuration

Set these as Space secrets (Settings → Variables and secrets):

VariablePurpose
GH_APP_PRIVATE_KEYPEM-encoded App private key. Newlines can be encoded as \n.
GH_WEBHOOK_SECRETWebhook secret you set on the GitHub App
HF_TOKENHF token with write scope; used to dispatch Jobs

Set these as regular Space variables:

VariablePurpose
GH_APP_IDYour GitHub App ID (number)
HF_NAMESPACE(optional) Namespace (user or org) under which jobs are launched & billed. Defaults to this Space's owner.
RUNNER_IMAGE_CPU(optional) Docker image for CPU jobs
RUNNER_IMAGE_GPU(optional) Docker image for GPU jobs
JOB_TIMEOUT(optional) Default per-job timeout, e.g. 1h

See setup/SETUP.md for the full walkthrough.

Endpoints

  • GET / — setup landing page with the GitHub App webhook URL
  • GET /healthz — liveness probe
  • POST /webhook — GitHub App webhook (HMAC-signed)

Contributors

abidlabs

25 commits

huggingface/jobs-actions-dispatcher

Space

1

stars

25

commits

1

linked in READMEs

Jun 5, 2026

updated

docker

README

jobs-actions Dispatcher

This Space is the dispatcher half of jobs-actions: it receives GitHub Actions workflow_job webhooks and launches HF Jobs to execute them.

Open the Space in a browser to see the GitHub App webhook URL for this Space. It will look like:

https://YOUR-SPACE-SUBDOMAIN.hf.space/webhook

Configuration

Set these as Space secrets (Settings → Variables and secrets):

VariablePurpose
GH_APP_PRIVATE_KEYPEM-encoded App private key. Newlines can be encoded as \n.
GH_WEBHOOK_SECRETWebhook secret you set on the GitHub App
HF_TOKENHF token with write scope; used to dispatch Jobs

Set these as regular Space variables:

VariablePurpose
GH_APP_IDYour GitHub App ID (number)
HF_NAMESPACE(optional) Namespace (user or org) under which jobs are launched & billed. Defaults to this Space's owner.
RUNNER_IMAGE_CPU(optional) Docker image for CPU jobs
RUNNER_IMAGE_GPU(optional) Docker image for GPU jobs
JOB_TIMEOUT(optional) Default per-job timeout, e.g. 1h

See setup/SETUP.md for the full walkthrough.

Endpoints

  • GET / — setup landing page with the GitHub App webhook URL
  • GET /healthz — liveness probe
  • POST /webhook — GitHub App webhook (HMAC-signed)

Contributors

abidlabs

25 commits