Resumen de trabajos

Hugging Face Jobs ejecuta tu código en CPUs y GPUs remotos. Úsalo para entrenar o afinar modelos, ejecutar inferencia sobre conjuntos de datos o procesar datos.

Un Job ejecuta un comando en un entorno sobre el hardware que elijas. Puedes seguir su estado y sus registros desde la terminal o en el Hub.

Comienza con la introducción rápida para ejecutar tus primeros trabajos de CPU y GPU, o explora los ejemplos para encontrar una carga de trabajo que adaptar.

Ejecuta trabajos desde cualquier lugar

Hay varias herramientas que puedes usar para ejecutar trabajos:

• la interfaz de línea de comandos hf (consulte los pasos de instalación de la CLI y la documentación de la CLI de Jobs para obtener más información)
• el cliente de Python huggingface_hub (consulte la documentación de Jobs de huggingface_hub para obtener más información)
• la API HTTP de Jobs (consulte la OpenAPI de Jobs para obtener más información)

Ejecutar cualquier carga de trabajo

Scripts de Python

Use hf jobs uv run para ejecutar un script de Python de forma remota. Especifique sus dependencias usando --with o en un encabezado del script. Jobs usa uv para instalar esas dependencias antes de ejecutar su código.

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

Imágenes de Docker

Usa hf jobs run con una imagen de Docker y el comando a ejecutar. La imagen proporciona las herramientas y bibliotecas que necesita tu carga de trabajo, ya que uses Python u otro lenguaje. Elige una imagen existente, usa una creada desde un Docker Space o crea la tuya.

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

Muchos Jobs pueden ejecutarse en paralelo, para tareas como el ajuste de parámetros, la inferencia y el procesamiento de datos.

Automatizar trabajos

Dispara trabajos automáticamente mediante un cronograma o usando webhooks.

Con un programa, puedes ejecutar Jobs cada X minutos, horas, días, semanas o meses. La programación de Jobs utiliza la sintaxis cron, como "*/5 * * * *" para “cada 5 minutos”, o alias como "@hourly", "@daily", "weekly" o "@monthly".

Con webhooks, los Jobs pueden ejecutarse siempre que haya una actualización en un repositorio de Hugging Face. Por ejemplo, puedes configurar webhooks para que se disparen con cada actualización de modelo bajo una cuenta determinada y recuperar el modelo actualizado desde el payload del webhook en el Job.