Jobs Catalog

Jobs Catalog

Lists job template Spaces on Hugging Face, builds a parameter form for each, and submits the job under your own account with live logs. A demo of what a Hub-native jobs page could look like.

Made by chris-rannou on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: Jobs Catalog is a demo of what a jobs page built into the Hugging Face Hub could look like. It lists job template Spaces and draws each template's parameter form from its template file. Submitting a job runs it in your own namespace on top of the template Space, and the cost is charged to you. Live logs show the job's progress.

Who it suits: It suits developers who want to run packaged jobs from a catalog, and people who build job templates and want to see how they could be listed.

Industry | Who uses it | How they use it | Example
Software | Developers | Browse templates and run one from its generated form | Submit a template job under their own account
Data work | Dataset owners | Run a packaged job on their data | Turn a document dataset into markdown
Games | Indie creators | Run a template that makes asset packs | Generate a retro game asset pack
Platform teams | Template authors | See how a template appears in a catalog | Add their own template to the list

You can skip it if you do not have a Hugging Face account, since jobs run in your own namespace and are billed to you.

Where to use it:

• A web browser: open the Space page on Hugging Face and sign in when it asks.
• Windows, macOS or Linux with Docker: build the image and run it yourself.

Use case | Who | What they get back
Browse templates | Anyone | A list of job template Spaces
Run a template job | Hub users | A job that runs in your namespace with live logs
Add a template | Template authors | Your template listed in the catalog

How to set it up: The hosted page needs a Hugging Face account to run a job. A local copy needs these things first.

• Docker on Windows, macOS or Linux.
• Python and pip, to download the files with the hf command.

1. Install the huggingface_hub package with pip.
2. Download the Space's files into a folder with the hf command.
3. Move into that folder.
4. Build the Docker image from the Dockerfile.
5. Run the image and map port 7860.

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

How to use it: Open the Space page and pick a template from the list. Fill in the form it shows, then submit the job. The job runs in your own namespace, and you can watch its logs as it goes. On your own computer, run the last two commands above and open port 7860.

To add a template, push a Space that has a template file, then append its id to the catalog file in this repository.

Tool | What it does
catalog.json | The list of templates the page shows
index.html | The page itself
app.js | The script that draws forms and submits jobs
server.py | A small server file in the repository

Example: You open the catalog and choose the template that turns a document dataset into markdown. You fill in its form and submit it. The job runs under your account and its logs scroll live in the page.

For newcomers and experts: If you are new, open the page and look at the two listed templates. Read what each one does before you run anything, because jobs are billed to you.

If you know the field, the catalog runs no compute itself. It is ordinary HTML and JavaScript, and it talks to the public Jobs API using the visitor's OAuth token. The README calls it a static Space, while the Hugging Face record shows a Dockerfile and a small server file. Each job uses the template Space as its base image.

You open the catalog and sign in
You pick a template from the list
A form is drawn from its template file
The job is submitted in your namespace
Live logs show its progress

Good to know: The catalog lists two templates today. One does OCR on a document dataset with Falcon-OCR, and the other makes retro game asset packs with SDXL-Turbo.

• License: mit
• Cost to run: jobs you submit are billed to your own Hugging Face account, and the catalog itself runs no compute
• Data it reaches: your Hugging Face account through an OAuth token, the Jobs API and your namespace
• Not for: running compute on the catalog's own side

On Hugging Face, 13 November 2026

• Likes: 2
• Built with: docker
• License: mit

Links

• Space: https://huggingface.co/spaces/chris-rannou/jobs-catalog
• Files: https://huggingface.co/spaces/chris-rannou/jobs-catalog/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.