> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monostate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Opciones Globales

> Opciones disponibles en todos los comandos CLI

# Opciones Globales

Estas opciones funcionan en la mayoría de comandos del CLI de AITraining.

## Versión

Verifica la versión instalada:

```bash theme={null}
aitraining --version
aitraining -v
```

## Ayuda

Obtén ayuda para cualquier comando:

```bash theme={null}
aitraining --help
aitraining llm --help
aitraining text-classification --help
```

## Archivo de Configuración

Carga parámetros desde un archivo de configuración YAML:

```bash theme={null}
aitraining --config path/to/config.yaml
```

Esto es útil para:

* Experimentos reproducibles
* Configuraciones complejas
* Compartir configuraciones con compañeros de equipo

## Backend

Especifica dónde se ejecuta el entrenamiento:

```bash theme={null}
aitraining llm --train --backend local ...
```

Backends disponibles:

| Backend    | Descripción                                                                    |
| ---------- | ------------------------------------------------------------------------------ |
| `local`    | Ejecutar en máquina local (predeterminado). Variantes: `local-cli`, `local-ui` |
| `spaces-*` | Ejecutar en Hugging Face Spaces                                                |
| `ep-*`     | Hugging Face Endpoints                                                         |
| `ngc-*`    | NVIDIA NGC/DGX Cloud                                                           |
| `nvcf-*`   | NVIDIA Cloud Functions                                                         |

### Opciones de Backend Spaces

| Backend               | GPU            |
| --------------------- | -------------- |
| `spaces-t4-small`     | T4 (small)     |
| `spaces-t4-medium`    | T4 (medium)    |
| `spaces-a10g-small`   | A10G (small)   |
| `spaces-a10g-large`   | A10G (large)   |
| `spaces-a10g-largex2` | 2x A10G        |
| `spaces-a10g-largex4` | 4x A10G        |
| `spaces-a100-large`   | A100           |
| `spaces-l4x1`         | 1x L4          |
| `spaces-l4x4`         | 4x L4          |
| `spaces-l40sx1`       | 1x L40S        |
| `spaces-l40sx4`       | 4x L40S        |
| `spaces-l40sx8`       | 8x L40S        |
| `spaces-cpu-basic`    | Solo CPU       |
| `spaces-cpu-upgrade`  | CPU (mejorado) |

<Warning>
  **Los backends remotos requieren autenticación**: Al usar backends no locales (`spaces-*`, `ep-*`, `ngc-*`, `nvcf-*`), debes proporcionar `--username` y `--token` para autenticación en Hugging Face.
</Warning>

<Note>
  **Push a Hub también requiere autenticación**: Incluso con `--backend local`, usar `--push-to-hub` requiere `--username` y `--token` para subir el modelo a Hugging Face Hub.
</Note>

## Variables de Entorno

Configura estas antes de ejecutar comandos:

### Autenticación

```bash theme={null}
export HF_TOKEN="hf_..."        # Token de Hugging Face
export WANDB_API_KEY="..."       # Clave de Weights & Biases
```

### Configuración de GPU

```bash theme={null}
export CUDA_VISIBLE_DEVICES=0,1  # Usar GPUs específicas
export PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:512  # Gestión de memoria
```

### Control MPS (Apple Silicon)

```bash theme={null}
export AUTOTRAIN_DISABLE_MPS=1  # Forzar entrenamiento CPU en Mac
export AUTOTRAIN_ENABLE_MPS=1   # Forzar MPS incluso con cuantización
```

## Modo Interactivo

Lanza el asistente de configuración:

```bash theme={null}
aitraining           # Sin argumentos = modo asistente
aitraining llm --interactive  # Modo interactivo explícito
```

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Configuraciones YAML" href="/cli/yaml-configs">
    Formato de archivo de configuración
  </Card>

  <Card title="Estructura de Comandos" href="/cli/command-structure">
    Referencia completa de comandos
  </Card>
</CardGroup>