hf CLI — Cheat-sheet NutriSense AI

🔑

Autenticación

hf auth

hf auth login

Login interactivo (pide token). Usar HF_TOKEN en CI/CD.

hf auth whoami

Muestra cuenta activa. Útil para verificar en pipelines.

hf auth list

Lista todos los tokens almacenados localmente.

hf auth switch --token-name prod-token

Cambia entre token dev/staging/prod sin re-login.

CI/CD — GitHub Actions

# .github/workflows/train.yml
env:
  HF_TOKEN: ${{ secrets.HF_TOKEN }}

steps:
  - $ hf auth whoami  # verifica
  - $ hf download nutrisense-ai/llama-nutri-3.1-8b

🧠

Modelos privado

hf models · hf download · hf upload

hf download nutrisense-ai/llama-nutri-3.1-8b

Descarga modelo completo al directorio de caché HF.

hf download nutrisense-ai/llama-nutri-3.1-8b --local-dir ./model --include "*.safetensors"

Descarga solo pesos .safetensors a carpeta local.

hf upload nutrisense-ai/llama-nutri-3.1-8b ./model/ --commit-message "v2.1 epoch-5"

Sube checkpoint fine-tuned en un commit.

hf models info nutrisense-ai/llama-nutri-3.1-8b --format json

Metadata JSON del modelo: revisión, tamaño, tags.

Subida con PR de revisión

$ hf upload nutrisense-ai/llama-nutri-3.1-8b ./ckpt/ \
    --create-pr \
    --commit-message "fine-tune semana 24"
# → abre PR en Hub para revisión antes de merge

📊

Datasets privado

hf datasets · parquet · sql

hf datasets info nutrisense-ai/pacientes-anonimizados

Metadatos: splits, filas, tamaño, última modificación.

hf datasets parquet nutrisense-ai/pacientes-anonimizados --split train

URLs de archivos Parquet para lectura directa con DuckDB/Pandas.

hf datasets sql "SELECT perfil_nutricional, COUNT(*) FROM nutrisense-ai/pacientes-anonimizados GROUP BY 1"

Query SQL directo sobre Parquet via DuckDB — sin descargar.

hf upload nutrisense-ai/pacientes-anonimizados ./data/ --type dataset --private

Sube nuevos datos del mes manteniendo repo privado.

EDA rápido desde terminal

$ hf datasets sql "SELECT edad_grupo, AVG(imc) \
  FROM nutrisense-ai/pacientes-anonimizados \
  WHERE split='train' GROUP BY 1 LIMIT 10"

🚀

Inference Endpoints GPU

hf endpoints — API privada para integración EHR clínicas

hf endpoints deploy nutri-api-prod --repo nutrisense-ai/llama-nutri-3.1-8b --accelerator gpu --vendor aws --region eu-west-1 --instance-type protected --min-replica 1 --max-replica 4 --scale-to-zero-timeout 300

Despliega endpoint privado con auto-scaling 1–4 replicas y scale-to-zero a 5 min.

hf endpoints describe nutri-api-prod

Estado del endpoint: URL, estado, replicas activas.

hf endpoints list

Lista todos los endpoints del namespace nutrisense-ai.

hf endpoints pause nutri-api-staging

Pausa el endpoint de staging fuera de horario laboral (ahorro de coste).

hf endpoints resume nutri-api-staging

Reactiva staging antes de tests de integración.

hf endpoints update nutri-api-prod --revision v2.1

Actualiza endpoint a nuevo checkpoint sin tiempo de inactividad.

hf endpoints scale-to-zero nutri-api-prod

Fuerza scale-to-zero manual (ej. fin de semana).

⚙️

Jobs GPU A10G

hf jobs — re-entrenamiento semanal

hf jobs run ghcr.io/nutrisense/train:latest python train.py --flavor a10g-large --env HF_REPO=nutrisense-ai/llama-nutri-3.1-8b --detach

Lanza job de entrenamiento en GPU A10G (24 GB VRAM) en background.

hf jobs scheduled run "0 2 * * 1" ghcr.io/nutrisense/train:latest python train.py --flavor a10g-large

Re-entrenamiento automático cada lunes a las 2am (cron).

hf jobs logs job_abc123 --follow

Streaming de logs en tiempo real (como docker logs -f).

hf jobs ps --all

Lista todos los jobs (activos + completados + fallidos).

hf jobs stats

Uso de GPU, memoria y coste acumulado del mes.

🌐

Spaces público

hf spaces — demo Gradio para clientes

hf spaces info nutrisense-ai/demo-nutri

Estado del Space: hardware, URL pública, SDK.

hf spaces hot-reload nutrisense-ai/demo-nutri --local-file app.py

Hot-reload de app.py sin rebuild completo. Ideal para demos en vivo.

hf spaces secrets add nutrisense-ai/demo-nutri --secrets API_KEY=xxx

Añade secreto al Space sin exponerlo en el código.

hf spaces settings nutrisense-ai/demo-nutri --hardware t4-small

Escala hardware del Space para demos con carga alta.

hf spaces logs nutrisense-ai/demo-nutri --follow

Logs de runtime en tiempo real para debugging.

📁

Repos & Cache

hf repos · hf cache · hf buckets

hf repos list --namespace nutrisense-ai

Lista todos los repos del namespace con tamaño de storage.

hf repos create nutrisense-ai/eval-benchmarks --type dataset --private

Crea repo de dataset privado para resultados de evaluación.

hf cache list --sort size:desc --limit 10

Top 10 repos que más espacio consumen en caché local.

hf cache prune

Elimina revisiones antiguas del caché. Libera GB en máquinas de training.

hf buckets create nutrisense-ai/checkpoints-eu --region eu

Bucket en zona EU para checkpoints intermedios (GDPR compliance).

💡

Tips y Patrones Avanzados

Mejores prácticas para equipos MLOps

🔐

Tokens en CI/CD

Nunca pasar --token en scripts. Usar siempre la variable de entorno HF_TOKEN con secretos del CI. Crear tokens de solo-lectura para inference.

⚡

Descarga parcial

Usar --include "*.safetensors" para bajar solo pesos. Combinar con --revision v2.1 para pinear versión exacta en producción.

📦

Upload grande

Para checkpoints >50 GB usar hf upload-large-folder con --num-workers 4. Es resumible ante cortes de red.

🗂️

hf-mount (sin copia)

Montar repos como filesystem local con hf-mount start repo nutrisense-ai/llama-nutri-3.1-8b /tmp/model. Archivos se cargan on-demand.

hf CLI — Referencia de Comandos

Pipeline MLOps NutriSense AI