Hub documentation
计划任务
计划任务
计划和将在 HF 基础设施上运行的任务。
使用 hf jobs uv run 或 hf jobs run，并设置计划为 @annually、@yearly、@monthly、@weekly、@daily、@hourly，或 CRON 计划表达式（例如，"0 9 * * 1" 表示每周一上午 9 点）：
# Schedule a job that runs every hour
>>> hf jobs scheduled uv run @hourly python -c "print('This runs every hour!')"
# Use the CRON syntax
>>> hf jobs scheduled uv run "*/5 * * * *" python -c "print('This runs every five minutes!')"
# Schedule with GPU
>>> hf jobs scheduled uv run --flavor a10g-small --with torch @hourly python -c 'import torch; print(f"This code ran with the following GPU: {torch.cuda.get_device_name()}")'
# Schedule with a Docker image
>>> hf jobs scheduled run @hourly python:3.12 python -c "print('This runs every hour!')"
# Schedule a Python script with a label
>>> hf jobs scheduled uv run --label fine-tuning @hourly my_script.py
# Schedule a named job (names show up in the UI and do not have to be unique)
>>> hf jobs scheduled run --name hourly-task @hourly python:3.12 python -c "print('This runs every hour!')"使用与 hf jobs uv run 和 hf jobs run 相同的参数来传递环境变量、密钥、超时、标签等。
使用 hf jobs scheduled ps、hf jobs scheduled inspect、hf jobs scheduled suspend、hf jobs scheduled resume、hf jobs scheduled reschedule、hf jobs scheduled trigger 和 hf jobs scheduled delete 管理计划任务：
# List your active scheduled jobs
>>> hf jobs scheduled ps
# List all your scheduled jobs (including suspended jobs)
>>> hf jobs scheduled ps -a
# Inspect the status of a job
>>> hf jobs scheduled inspect <scheduled-job-id>
# Suspend (pause) a scheduled job
>>> hf jobs scheduled suspend <scheduled-job-id>
# Resume a scheduled job
>>> hf jobs scheduled resume <scheduled-job-id>
# Change when a scheduled job runs (here, 9 AM every Monday)
>>> hf jobs scheduled reschedule <scheduled-job-id> "0 9 * * 1"
# Trigger a scheduled job to run right now (does not change the schedule)
>>> hf jobs scheduled trigger <scheduled-job-id>
# Delete a scheduled job
>>> hf jobs scheduled delete <scheduled-job-id>