Antes de empezar
Instalaremos todo directamente en tu PC con Windows 10/11. Solo necesitas conexión a internet y unos 20 minutos. Descarga siempre desde los botones oficiales de esta guía. Si inicias sesión, cada paso que marques se guardará y avanzará tu barra de progreso.
Visual Studio Code
El editor donde abrimos el proyecto, vemos las carpetas, editamos código y usamos la terminal integrada.
- Descarga el Windows · User Installer · x64 desde la web oficial.El "User Installer" no pide permisos de administrador: es el más sencillo.
- Ejecuta el instalador y acepta el acuerdo de licencia.
- En "Tareas adicionales", marca las casillas útiles.Recomendado: "Agregar la acción Abrir con Code" al menú de archivos y carpetas, y "Agregar a PATH" (suele venir marcada).
- Termina la instalación con el resto por defecto y abre VS Code.Si quieres, instala la extensión Spanish Language Pack desde Extensiones (Ctrl+Shift+X).
Git for Windows
Permite manejar versiones, descargar proyectos desde GitHub y trae Git Bash, una terminal muy útil.
- Descarga "Git for Windows" (instalador de 64 bits) y ejecútalo.
- Cuando pregunte por el editor por defecto, elige Visual Studio Code.Si VS Code aún no aparece, deja la opción por defecto; no es crítico.
- En la pantalla del PATH, deja la opción del medio (recomendada)."Git from the command line and also from 3rd-party software". Así
gitfunciona en PowerShell, CMD y VS Code. - Acepta el resto de pantallas con sus valores por defecto y finaliza.No necesitas cambiar nada más para el curso.
Node.js LTS
Node trae npm, que usamos para instalar dependencias y levantar el panel ETABS en React.
- Entra a
nodejs.orgy descarga la versión LTS para Windows (x64, instalador .msi)."LTS" = soporte a largo plazo, la opción estable. No uses la "Current". - Ejecuta el instalador y acepta la licencia.
- Mantén marcado "Add to PATH" (viene por defecto) y continúa.Puedes dejar SIN marcar "Automatically install the necessary tools" (Chocolatey): no hace falta para el curso.
- Finaliza y cierra y vuelve a abrir PowerShell o VS Code.Reabrir la terminal es lo que hace que reconozca
nodeynpm.
npm install # instala las dependencias del panel
npm run dev # abre el panel en modo desarrollo (127.0.0.1:5173)
npm run build # genera la versión final
Python 3.12
Es el motor del servidor: ejecuta FastAPI, controla ETABS por API COM (comtypes) y corre OpenSeesPy.
- Descarga el Windows installer (64-bit) de Python 3.12.x desde python.org.Por ejemplo, la versión 3.12.13. Baja hasta la sección "Files" y elige el de 64 bits.
- En la PRIMERA pantalla del instalador, marca "Add python.exe to PATH".⚠️ Es la casilla más importante. Si la olvidas, los comandos
pythonypyno funcionarán. - Haz clic en "Install Now" y espera a que termine.
- Si aparece al final, pulsa "Disable path length limit" y cierra.Evita errores con rutas largas de carpetas en Windows.
py -3.12 para llamar a la correcta.Verifica que todo quedó instalado
Abre una terminal nueva y ejecuta los comandos. Si cada uno devuelve una versión, ¡estás listo!
py -3.12 --version
python --version
node --version
npm --version
git --version
py -3.12 --version
node --version
npm --version
git --version
python --version
node --version
npm --version
git --version
Deberías ver algo así
- Python 3.12.13
- v20.x.x (Node)
- 10.x.x (npm)
- git version 2.x
- Los comandos devuelven una versión sin errores.
- Python responde 3.12.x (no 3.13).
Errores comunes y cómo resolverlos
La mayoría de fallas son por PATH o por una terminal abierta antes de instalar. Toca cada caso para ver la solución.
"node" / "python" / "git" no se reconoce como comando
Casi siempre es porque la terminal estaba abierta antes de instalar. Ciérrala por completo y abre una nueva.
Si después de reabrir sigue igual, reinstala el programa asegurándote de marcar "Add to PATH".
Python me sale con otra versión (3.13, 3.11…)
Llama explícitamente a la 3.12 con py -3.12. Para ver todas las versiones instaladas:
py -0p
El curso usa 3.12 porque OpenSeesPy en Windows no funciona con 3.13.
npm bloqueado en PowerShell (scripts deshabilitados)
Usa CMD en lugar de PowerShell, o habilita los scripts del usuario con este comando (solo afecta a tu usuario):
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
El instalador parece sospechoso o pide pagar
Cancela de inmediato. Todas estas herramientas son gratuitas. Descarga solo desde los botones oficiales de esta guía: nodejs.org, python.org, code.visualstudio.com y git-scm.com.
Mi avance no se guarda / no aparece para el profesor
Asegúrate de haber iniciado sesión (arriba a la derecha debe aparecer tu nombre). Tu avance se sincroniza solo al marcar cada paso.
Tu código de acceso (ej. ia-001) solo se usa una vez, al crear la cuenta. Después entras siempre con tu correo y contraseña, incluso desde otro equipo.
🚀 Siguiente: preparar el proyecto ETABS + IA
Con las herramientas listas, copiamos el proyecto, creamos el entorno osenv312, instalamos dependencias y arrancamos el servidor.
# dentro de la carpeta del proyecto
py -3.12 -m venv osenv312
.\osenv312\Scripts\python.exe -m pip install --upgrade pip
.\osenv312\Scripts\python.exe -m pip install -r requirements.txt