Instala la CLI heredada de Python para el tiempo de ejecución de IA

Importante

Esta documentación se ha retirado y es posible que no se actualice.

La CLI basada air en Python, instalada con el databricks-air paquete, está ahora obsoleta y ya no se mantiene activamente.

Usa la CLI de Databricks para nuevas cargas de trabajo. Consulta Usar la CLI de Databricks con AI Runtime.

Instale la air CLI con uv y autentíquela con un área de trabajo de Databricks usando un perfil de Databricks CLI. La CLI requiere Python 3.10 o posterior.

Requisitos

Instalación de la CLI

Databricks recomienda instalar la CLI con uv:

uv tool install --force databricks-air --python 3.12

uv tool install coloca air en su propio entorno aislado y lo expone en su PATH, por lo que no entra en conflicto con el intérprete de Python que usa para el código de entrenamiento.

--python 3.12 se recomienda, pero opcional. Si no especificas la versión de Python, uv utiliza la última versión disponible que cumpla con la restricción de Python del paquete.

Si aún no tiene uv, instálelo primero:

curl -LsSf https://astral.sh/uv/install.sh | sh

Compruebe la instalación:

air --version
air --help

Authenticate

La CLI de AI Runtime reutiliza los perfiles de autenticación de la CLI de Databricks. Inicie sesión en el área de trabajo y asigne un nombre al perfil cuando se le solicite:

databricks auth login --host https://<your-workspace>.cloud.databricks.com

Pase el nombre del perfil a cualquier comando air con -p. Por ejemplo:

air list runs -p my-workspace

Como alternativa, establezca DATABRICKS_CONFIG_PROFILE en el intérprete de comandos para establecer un perfil como predeterminado:

export DATABRICKS_CONFIG_PROFILE=my-workspace

Para ver todas las opciones de autenticación, consulte Autenticación para la CLI de Databricks.

Recursos adicionales

Después de instalar, defina las cargas de trabajo en un archivo train.yaml config con dependencias en línea. Comience con el inicio rápido y, a continuación, use la referencia de YAML a medida que compile la configuración: