> ## 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.

# Instalación y Configuración

> Prepara el CLI de AITraining para usar

# Instalación y Configuración

El CLI de AITraining está incluido cuando instalas el paquete `aitraining`.

## Instalación

### Usando pip

```bash theme={null}
pip install aitraining torch torchvision torchaudio
```

### Usando uv (Recomendado)

```bash theme={null}
uv pip install aitraining torch torchvision torchaudio
```

## Verificar Instalación

Verifica que el CLI funciona:

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

Deberías ver el número de versión impreso.

## Primera Ejecución

Ejecutar `aitraining` sin argumentos inicia el asistente interactivo:

```bash theme={null}
aitraining
```

Esto muestra el banner de Monostate e inicia el asistente de configuración.

## Configuración de GPU

Para entrenamiento con GPU, asegúrate de tener CUDA instalado y que PyTorch pueda detectar tu GPU:

```python theme={null}
import torch
print(torch.cuda.is_available())  # Should print True
print(torch.cuda.device_count())  # Number of GPUs
```

### Apple Silicon (M1/M2/M3)

En Macs Apple Silicon, MPS se usa automáticamente:

```python theme={null}
import torch
print(torch.backends.mps.is_available())  # Should print True
```

## Variables de Entorno

Variables de entorno comunes:

| Variable               | Descripción                                          |
| ---------------------- | ---------------------------------------------------- |
| `HF_TOKEN`             | Token de Hugging Face para modelos/datasets privados |
| `WANDB_API_KEY`        | Clave API de Weights & Biases para logging           |
| `CUDA_VISIBLE_DEVICES` | Especificar qué GPUs usar                            |

Configura estas antes de ejecutar el entrenamiento:

```bash theme={null}
export HF_TOKEN="your_token_here"
export WANDB_API_KEY="your_key_here"
```

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Estructura de Comandos" href="/cli/command-structure">
    Aprende la sintaxis de comandos CLI
  </Card>

  <Card title="Entrenamiento LLM" href="/cli/llm-training">
    Entrena modelos de lenguaje
  </Card>
</CardGroup>