Visão geral dos trabalhos

Hugging Face Jobs executa seu código em CPUs e GPUs remotos. Use-o para treinar ou ajustar finamente modelos, executar inferência em conjuntos de dados ou processar dados.

Um Job executa um comando em um ambiente no hardware que você escolher. Você pode acompanhar seu status e logs pelo terminal ou no Hub.

Comece pelo Quickstart para executar seus primeiros Jobs de CPU e GPU, ou veja exemplos para uma carga de trabalho para adaptar.

Execute Jobs de qualquer lugar

Existem várias ferramentas que você pode usar para executar jobs:

• a Interface de Linha de Comando hf (consulte as etapas de instalação da CLI e a documentação da CLI de Jobs para mais informações)
• o cliente Python huggingface_hub (consulte a documentação de Jobs do huggingface_hub para mais informações)
• a API HTTP de Jobs (consulte o Jobs OpenAPI para mais informações)

Execute qualquer carga de trabalho

Scripts em Python

Use hf jobs uv run para executar um script Python remotamente. Especifique suas dependências usando --with ou em um cabeçalho do script. O Jobs usa o uv para instalar essas dependências antes de executar seu código.

- uv run <script.py>
+ hf jobs uv run <script.py>

Imagens Docker

Use hf jobs run com uma imagem Docker e o comando a ser executado. A imagem fornece as ferramentas e bibliotecas necessárias para sua carga de trabalho, independentemente de você estar usando Python ou outra linguagem. Escolha uma imagem existente, use uma construída a partir de um Docker Space ou crie a sua própria.

- docker run <image> <command>
+ hf jobs run <image> <command>

Muitos Jobs podem ser executados em paralelo, para tarefas como ajuste de parâmetros, inferência e processamento de dados.

Automatizar Jobs

Dispare Jobs automaticamente com um agendamento ou usando webhooks.

Com um agendamento, você pode executar Jobs a cada X minutos, horas, dias, semanas ou meses. O agendamento de Jobs usa a sintaxe cron, como "*/5 * * * *" para “a cada 5 minutos”, ou aliases como "@hourly", "@daily", "weekly" ou "@monthly".

Com webhooks, os Jobs podem ser executados sempre que houver uma atualização em um repositório do Hugging Face. Por exemplo, você pode configurar webhooks para serem acionados a cada atualização de modelo em uma determinada conta e recuperar o modelo atualizado do payload do webhook no Job.