Hub documentation

Agendar Tarefas

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Agendar Tarefas

Agende e gerencie jobs que serão executados na infraestrutura da HF.

Use hf jobs uv run ou hf jobs run com um agendamento de @annually, @yearly, @monthly, @weekly, @daily, @hourly ou uma expressão de agendamento CRON (por exemplo, "0 9 * * 1" para 9h de toda segunda-feira):

# 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!')"

Use os mesmos parâmetros de hf jobs uv run e hf jobs run para passar variáveis de ambiente, segredos, timeout, rótulos, etc.

Gerencie trabalhos agendados usando hf jobs scheduled ps, hf jobs scheduled inspect, hf jobs scheduled suspend, hf jobs scheduled resume, hf jobs scheduled reschedule, hf jobs scheduled trigger e 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>
Update on GitHub