CLI Reference

tip

Todos los comandos soportan --help para ver sus opciones:

godml run --help
godml dataprep --help

CLI Reference

godml [COMANDO] [OPCIONES]

Comandos

godml run

Ejecuta un pipeline completo: carga, limpieza, compliance, entrenamiento, evaluación y registro.

godml run -f godml.yml

Opción	Descripción
-f, --file	Ruta al archivo YAML del pipeline. Default: godml.yml

Ejemplos:

godml run -f pipelines/churn.yml
godml run -f s3://mi-bucket/configs/churn.yml  # próximamente

---

godml init

Crea la estructura de un nuevo proyecto godml.

godml init mi-proyecto

Genera:

mi-proyecto/
├── godml.yml
├── data/
│   └── .gitkeep
└── output/
    └── .gitkeep

---

godml serve

Levanta un servidor FastAPI para servir predicciones en tiempo real.

godml serve dev

Endpoints disponibles:

• POST /predict — predicción individual
• GET /health — health check
• GET /docs — Swagger UI

---

godml deploy

Empaqueta el modelo en Docker para producción.

godml deploy mi-proyecto dev

---

godml calc-hash

Calcula el SHA-256 de un dataset para trazabilidad.

godml calc-hash ./data/train.csv
# Hash SHA-256 para .../data/train.csv:
# a3f8c2...

Con --update-yaml godml.yml escribe el hash calculado directamente en dataset.hash del YAML indicado.

---

godml dataprep run

Ejecuta una receta de DataPrep independiente del pipeline.

godml dataprep run recipe.yml

---

Variables de entorno del CLI

Variable	Descripción
MLFLOW_TRACKING_URI	URI del backend de MLflow. Default: sqlite:///mlflow.db
MLFLOW_EXPERIMENT_NAME	Nombre del experimento en MLflow. Default: godml-experiment
SAGEMAKER_ROLE_ARN	Valor para interpolar ${SAGEMAKER_ROLE_ARN} dentro de aws.role_arn en el YAML
GODML_SAGEMAKER_ROLE	ARN del IAM role para SageMaker cuando el YAML no define el bloque aws: (si tampoco está seteada, godml intenta sagemaker.get_execution_role())
GODML_S3_BUCKET	Bucket S3 cuando el YAML no define aws: (alternativa: sagemaker.Session().default_bucket())
AWS_DEFAULT_REGION	Región AWS cuando el YAML no define aws:. Default: us-east-1