Manual de la sesión — clonaremos el repositorio del curso y crearemos tu primer entorno virtual, todos juntos y paso a paso.
Esta sesión es 100 % práctica y avanza en bloque: quien llegue sin los requisitos no podrá seguirla. No repetiremos aquí ningún paso de instalación ni de creación de cuentas; verifica esta lista y, si te falta algo, resuélvelo antes de la clase por el canal de ayuda.
nombre-apellido, y anota tu contraseña).propedeutico.propedeutico y pulsa Seleccionar carpeta.propedeutico. Todo lo que ejecutes ocurre ahí.mi-proyecto). Los espacios y caracteres especiales en las rutas son una fuente clásica de errores difíciles de detectar..git).La dirección tiene siempre la forma https://github.com/usuario/repositorio.git. Ese mismo botón sirve para clonar cualquier repositorio público de GitHub.
En la terminal de VS Code escribe git clone, un espacio, y pega la dirección (clic derecho → Pegar, o Ctrl+V / ⌘V). Presiona Enter:
git clone https://github.com/usuario/repositorio.git
~/Documentos/propedeutico> git clone https://github.com/usuario/repositorio.git Cloning into 'repositorio'... remote: Enumerating objects: 87, done. remote: Counting objects: 100% (87/87), done. Receiving objects: 100% (87/87), 1.24 MiB | 2.10 MiB/s, done. Resolving deltas: 100% (31/31), done.
propedeutico apareció una carpeta nueva con el nombre del repositorio: es tu copia local, con todos los materiales.git pull y las novedades bajan solas. Esa es la ventaja de clonar frente a descargar un ZIP.Lo haremos por la vía integrada de VS Code, que es idéntica en Windows y Mac:
requirements.txt en el repositorio, marca su casilla: instalará automáticamente las librerías del curso. Pulsa OK..venv: esa carpeta es tu entorno. No la toques ni la borres.Comprueba que está activo: abre una terminal nueva (Terminal → New Terminal). El indicador (.venv) al inicio de la línea confirma que estás dentro de la caja:
(.venv) ~/Documentos/propedeutico/repositorio>
(.venv) no aparece, actívalo tú desde la carpeta del repositorio — WIN .venv\Scripts\activate · MAC source .venv/bin/activate — y para salir del entorno, en ambos sistemas: deactivate. Si Windows responde «la ejecución de scripts está deshabilitada», la solución está en P2.El mismo resultado sin la paleta de comandos. Primero, parado dentro de la carpeta del repositorio clonado (la terminal integrada de VS Code ya se abre ahí), crea el entorno — WIN:
python -m venv .venv
MAC (fuera del entorno, el Python moderno se llama python3):
python3 -m venv .venv
Después actívalo — WIN:
.venv\Scripts\activate
MAC:
source .venv/bin/activate
Cuando aparezca el (.venv) al inicio de la línea, listo. Por esta vía no hay casilla de requirements.txt, así que nada se instala solo: el paso 5 es obligatorio. Si Windows responde «la ejecución de scripts está deshabilitada», la solución está en P2.
Última comprobación del paso: con el (.venv) visible, pide la lista de librerías instaladas. El comando es el mismo en Windows y Mac:
pip list
Si al crear el entorno marcaste la casilla de requirements.txt, en la lista deben aparecer las siete librerías del curso — ipykernel, matplotlib, numpy, openpyxl, pandas, scipy y sympy — junto a otras que se instalan solas como acompañantes:
(.venv) ~/Documentos/propedeutico/repositorio> pip list Package Version ---------------- ----------- … ipykernel 7.3.0 matplotlib 3.11.0 numpy 2.5.1 openpyxl 3.1.5 pandas 3.0.3 … scipy 1.18.0 sympy 1.14.0 …
¿No aparecen, o la lista sale casi vacía? No pasa nada: el paso 5 lo resuelve con un solo comando.
Si al crear el entorno marcaste la casilla de requirements.txt, este paso ya ocurrió solo — y pip list te lo confirmó. Pero si no la marcaste, creaste el entorno por la terminal, o algo falló y las librerías no aparecen, esta es la red de seguridad. Con el (.venv) visible, este comando es el mismo en Windows y Mac:
python -m pip install -r requirements.txt
requirements.txt es la lista de compras del proyecto: un archivo que vive en el repositorio y declara las siete librerías del curso con sus versiones exactas. Ese único comando las instala todas de una vez (la terminal ya está parada en la carpeta del repositorio, donde vive el archivo) — y como viaja con el repositorio, cualquiera que lo clone puede reconstruir el mismo entorno.
¿Por qué “dentro del entorno”? Con el (.venv) activo, las librerías se instalan dentro de la caja del proyecto, no en el Python “general” de tu máquina. Cada entorno lleva sus propias herramientas — por eso los proyectos no se estorban entre sí.
clases/clase01_conjuntos_producto_cartesiano.ipynb.Si la celda corre, acabas de reproducir en tu propia máquina todo el flujo profesional: repositorio clonado → entorno propio → código ejecutando. Esto es exactamente lo que hacías en Colab, pero ahora el laboratorio es tuyo.
Antes de cerrar la laptop, verifica que puedes marcar todo:
Cinco comandos para no perderte nunca en la terminal. Los usaremos todo el semestre:
| Comando | Qué hace |
|---|---|
pwd | Muestra en qué carpeta estás “parado” ahora mismo. |
ls (en Windows también sirve dir) | Lista el contenido de la carpeta actual. |
cd nombre-carpeta | Entra a una carpeta que esté dentro de la actual. |
cd .. | Regresa a la carpeta anterior (un nivel arriba). |
mkdir nombre-carpeta | Crea una carpeta nueva donde estás parado. |
git clone responde “repository not found” o “could not resolve host”Casi siempre es la dirección mal copiada o incompleta. Vuelve al repositorio en el navegador, botón <> Code → pestaña HTTPS → icono de copiar, y pega de nuevo. “Could not resolve host” indica además un problema de internet: verifica tu conexión (o el wifi del aula).
Es una protección de PowerShell que bloquea la activación del entorno. Ejecuta en la terminal:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Responde S (o Y) si pregunta, cierra esa terminal y abre una nueva. El (.venv) debería aparecer.
Falta la extensión Python de Microsoft (sección D del Manual de instalación) o VS Code necesita reiniciarse tras instalarla. Instálala desde el panel de extensiones, cierra y vuelve a abrir VS Code.
(.venv)Las terminales abiertas antes de crear el entorno no se enteran de que existe: ciérralas y abre una nueva. Si persiste, abre la paleta (Ctrl+Shift+P / ⇧⌘P) → Python: Select Interpreter → elige el que dice .venv, y abre otra terminal.
El repositorio del curso es público y clonar no debería pedir nada. Si aparece una ventana del navegador pidiendo autorizar, pulsa Authorize e inicia sesión con tu cuenta de GitHub. Si la terminal pide usuario y contraseña en texto, primero revisa la dirección (P1); si la dirección es correcta, avisa al docente.
Pulsa Select Kernel → Python Environments → .venv. Si VS Code ofrece instalar ipykernel, acepta; equivale al paso 5.
Ejecuta pwd para ver dónde estabas parado al clonar: la copia se creó ahí. No pasa nada grave: puedes mover la carpeta completa del repositorio a Documentos/propedeutico con el explorador o el Finder sin romper nada, y volver a abrirla desde VS Code.
Estoy siguiendo un manual del curso propedéutico de FLACSO y me atasqué en [paso o sección del manual donde estabas]. Mi sistema operativo es [Windows o Mac]. Escribí este comando o código: [pega aquí exactamente lo que escribiste] Y obtuve este mensaje de error o problema: [pega aquí el mensaje completo, copiado desde la terminal] Por favor: primero explícame por qué ocurre el problema, en lenguaje sencillo (no tengo experiencia en programación), y después dame los pasos para resolverlo, uno por uno.
Hoy recibiste código: clonaste un repositorio ajeno y montaste tu laboratorio local. En la próxima sesión harás el camino inverso: crear tu propio repositorio, guardarle cambios con git add y git commit, y publicarlos en tu GitHub con git push — tu portafolio público empieza ahí. El paso a paso completo ya está publicado en el Manual de la clase 3 — Tu propio repositorio en GitHub.