Add minimal hfjobs uv run command

[davanstrien]

WIP adds a super minimal MVP version of the UV run (will keep #7 for further UX experiments with different workflows, etc.).

Usage

hfjobs uv --help
usage: hfjobs <command> [<args>] uv [-h] {run} ...

positional arguments:
  {run}       UV commands
    run       Run a UV script (local file or URL) on HF infrastructure

options:
  -h, --help  show this help message and exit

hfjobs uv run --help
usage: hfjobs <command> [<args>] uv run [-h] [--repo REPO] [--flavor FLAVOR] [-e ENV] [-s SECRET] [--timeout TIMEOUT] [-d] [--token TOKEN] script [script_args ...]

positional arguments:
  script                UV script to run (local file or URL)
  script_args           Arguments for the script

options:
  -h, --help            show this help message and exit
  --repo REPO           Repository name for the script (creates ephemeral if not specified)
  --flavor FLAVOR       Hardware flavor (default: cpu-basic)
  -e ENV, --env ENV     Environment variables
  -s SECRET, --secret SECRET
                        Secret environment variables
  --timeout TIMEOUT     Max duration (e.g., 30s, 5m, 1h)
  -d, --detach          Run in background
  --token TOKEN         HF token

What are UV scripts?

UV scripts are Python scripts with inline dependencies. Here's a simple example:

# /// script
# requires-python = ">=3.10"
# dependencies = [
#     "requests",
#     "rich",
# ]
# ///

import requests
from rich import print

response = requests.get("https://api.github.com")
print(f"[green]GitHub API status:[/green] {response.status_code}")

Examples

Supports running from a local Python file:

And from a public URL:

Note on private repositories

Currently, it only supports using a public repository for the ephemeral storage of scripts. I would suggest we start with that for the launch and add a --private flag post-launch. @lhoestq WDYT?

[lhoestq]

LGTM ! Let me know if you'd like to do more changes but IMO this can be integrated as is :)

[davanstrien]

Good to merge from my side. I can copy the env etc. logic from run.py. will do that first thing tomorrow

…

On Thu, 10 Jul 2025, 17:20 Quentin Lhoest, ***@***.***> wrote: ***@***.**** approved this pull request. LGTM ! Let me know if you'd like to do more changes but IMO this can be integrated as is :) ------------------------------ In hfjobs/commands/uv.py <#8 (comment)>: > + run_parser.add_argument( + "-e", "--env", action="append", help="Environment variables" + ) + run_parser.add_argument( + "-s", "--secret", action="append", help="Secret environment variables" + ) you can also copy paste the --env-file and --secret-env-file logic from run.py (I can also do it when integrating in huggingface/huggingface_hub#3211 <huggingface/huggingface_hub#3211>) — Reply to this email directly, view it on GitHub <#8 (review)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACEUI5K334XU2T3AFD5JY4L3H2HE5AVCNFSM6AAAAACBEROUKKVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZTAMBWGQZTAMJYGI> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[davanstrien]

@lhoestq think this is ready now! I did add a warning Note: hfjobs uv run is experimental and subject to change. at the top of the logs for now!