/setup-start.es

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Codex Desktop o Cursor instalado"]
level: "beginner"
tags: ["setup", "environment"]
nonInteractiveMode: deferred

Configuración del entorno de capacitación

Step 0: Verificar progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-start` para mostrar el progreso actual 2. Verificar automáticamente lo siguiente; si todo tiene éxito, preguntar "Las herramientas básicas ya están instaladas. ¿Desea omitir?":

• `python3 --version`
• `node --version`
• `git --version`
• `gh --version`

3. En Mac, verificar si Homebrew está disponible con `which brew`. Si está disponible, ofrecer la opción de instalar automáticamente las herramientas faltantes con `brew install`

Lo que hará en esta sesión

**¡Bienvenido a la configuración del entorno de capacitación!**

| Elemento | Contenido | |----------|-----------| | Objetivo | Verificar que Python / Node.js / Git / GitHub CLI estén instalados, y guiar la instalación si falta algo | | Duración | ~10 minutos (3 minutos si todo ya está instalado) | | Habilidades utilizadas | Ninguna (la IA verifica todo automáticamente) | | Requisitos previos | Codex Desktop o Cursor instalado, carpeta ai-agent-camp abierta | | Siguiente comando | `/setup-github` (configuración de cuenta de GitHub) |

**Flujo de la sesión:** 1. Detección automática del sistema operativo (Mac / Windows) 2. Verificar Python 3. Verificar Node.js 4. Verificar Git 5. Verificar GitHub CLI

> **Importante**: No necesita escribir ningún comando en el terminal. La IA ejecuta todo automáticamente en segundo plano. Solo revise los resultados que se muestran en pantalla. > > **Nota para Codex**: En Codex, en lugar de llamar `/setup-start` como comando slash, siga los elementos de verificación de este documento en orden. La IA le delegará solo los pasos que requieran descargas o autenticación del navegador. > > **Consejo**: Si la IA deja de responder a mitad del proceso, escriba "por favor continúa" o "se detuvo" para reanudar. Este es un comportamiento de Cursor, no una falla.

---

Confirmación previa a la sesión

**Configuración de AskQuestion:**

{
  "title": "Confirmación previa a la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está listo?",
    "options": [
      {"id": "ready", "label": "¡Listo! Comencemos"},
      {"id": "what_is_this", "label": "¿Qué hace este comando?"},
      {"id": "different_lesson", "label": "Ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (what_is_this -> Indicar: "Este comando hace que la IA verifique automáticamente si el software necesario para la capacitación está instalado en su computadora. Si falta algo, solo siga las instrucciones en pantalla para instalarlo. No necesita ingresar ningún comando." -> Ir al Step 1) (different_lesson -> Mostrar lista de módulos)

---

Step 1: Detección automática del sistema operativo

**Lo que la IA ejecuta automáticamente:** La IA ejecuta lo siguiente en segundo plano para detectar el sistema operativo:

uname -s

Mac devuelve `Darwin`, Linux/WSL devuelve `Linux`. Si devuelve `Linux`, verificar adicionalmente si es WSL:

grep -qi microsoft /proc/version 2>/dev/null && echo "WSL" || echo "Native Linux"

**Mostrar el resultado de la detección:**

• Mac: "Su computadora es un **Mac**. Procederemos con los pasos específicos para Mac."
• WSL: "Su computadora ejecuta **Windows (WSL)**. Procederemos con los pasos basados en Linux."
• Linux: "Su computadora ejecuta **Linux**. Procederemos con los pasos específicos para Linux."

**La información del sistema operativo detectado se usa en todos los pasos siguientes.**

> Acción requerida del usuario: Ninguna (la IA detecta todo automáticamente)

---

Step 2: Verificar Python

**Lo que la IA ejecuta automáticamente:**

1. Ejecutar lo siguiente para verificar la versión:

# Mac / Linux
python3 --version

# Windows
python --version

2. Evaluar el resultado:

• Si se muestra una versión -> Instalado
• Si no se encuentra el comando -> No instalado

Si Python está instalado

Ejemplo de visualización:

Python 3.12.x encontrado. Sin problemas.

-> Proceder automáticamente al Step 3

Si Python no está instalado

**Configuración de AskQuestion:**

{
  "title": "Se requiere instalar Python",
  "questions": [{
    "id": "python_install",
    "prompt": "Python 3 no está instalado. Le guiaremos a través de la instalación.",
    "options": [
      {"id": "guide_me", "label": "Muéstreme los pasos de instalación"},
      {"id": "already_done", "label": "Lo instalé de otra manera (volver a verificar)"}
    ]
  }]
}

(guide_me -> Mostrar instrucciones específicas del sistema operativo) (already_done -> Volver a ejecutar `python3 --version` / `python --version` para verificar)

**Instrucciones para Mac:**

Siga estos pasos para instalar:

1. La IA abrirá automáticamente su navegador (espere un momento)
2. Haga clic en el botón amarillo "Download Python 3.12.x" en la página
3. Haga doble clic en el archivo .pkg descargado
4. Siga el instalador: haga clic en "Continuar" -> "Instalar"
5. Cuando termine, escriba "terminé" aquí

La IA ejecuta: open https://www.python.org/downloads/

**Instrucciones para Windows:**

Siga estos pasos para instalar:

1. La IA abrirá automáticamente su navegador (espere un momento)
   * Si el navegador no se abre, abra la aplicación Microsoft Store y busque "Python 3.12"
2. Haga clic en el botón "Obtener" para "Python 3.12" en Microsoft Store
3. Cuando se complete la instalación, escriba "terminé" aquí

La IA ejecuta: start https://apps.microsoft.com/search?query=Python+3.12
# Si falla, cambia a start https://www.python.org/downloads/

**Después de la instalación:** La IA vuelve a ejecutar `python3 --version` / `python --version` para verificar.

• Éxi