La siguiente es una guía lista para compartir con los estudiantes. Esta adaptada para Windows, clonando el repositorio en el disco C:\ y trabajando desde VSCode.

El repositorio está público en GitHub como justorfc/design y contiene una app multipágina de Streamlit con archivos principales como app.py, requirements.txt, carpetas pages/ y utils/. (GitHub) La documentación del propio repositorio indica que se clona con git clone https://github.com/justorfc/design.git, se instalan dependencias con pip install -r requirements.txt y se ejecuta con streamlit run app.py. (GitHub)

Guía paso a paso para clonar y ejecutar la App Design

1. Requisitos previos

Antes de iniciar, cada estudiante debe tener instalado:

  1. Git Permite clonar el repositorio desde GitHub. URL: https://github.com/justorfc/design.git

  2. Visual Studio Code Será el editor de código.

  3. Python 3.10 o superior El repositorio indica como requisito Python 3.10 o superior, además de Streamlit, pandas, numpy y scipy. (GitHub)

  4. Extensión de Python en VSCode Desde VSCode, ir a Extensions y buscar:

Python

Instalar la extensión oficial de Microsoft.

2. Verificar que Git y Python estén instalados

Abrir PowerShell o la terminal de Windows y escribir:

git --version

Debe aparecer algo similar a:

git version 2.x.x

Luego verificar Python:

python --version

o, si no funciona:

py --version

Debe aparecer algo similar a:

Python 3.10.x

3. Crear una carpeta de trabajo en el disco C:

Se recomienda no clonar directamente dentro de carpetas del sistema como C:\Windows o C:\Program Files.

En PowerShell, ejecutar:

cd C:\
mkdir Proyectos
cd Proyectos

Con esto se crea la carpeta:

C:\Proyectos

4. Clonar el repositorio desde GitHub

Dentro de C:\Proyectos, ejecutar:

git clone https://github.com/justorfc/design.git

GitHub recomienda el uso de git clone para crear una copia local del repositorio en el computador. (GitHub Docs)

Al finalizar, se habrá creado la carpeta:

C:\Proyectos\design

Ingresar a esa carpeta:

cd design

5. Abrir el proyecto en VSCode

Desde la misma terminal, escribir:

code .

Si el comando code . no funciona, abrir VSCode manualmente y hacer:

File → Open Folder → C:\Proyectos\design

6. Crear el entorno virtual de Python

Dentro de VSCode, abrir la terminal integrada:

Terminal → New Terminal

Verificar que la terminal esté ubicada en:

C:\Proyectos\design

Crear el entorno virtual:

python -m venv .venv

Si el comando anterior no funciona, intentar:

py -m venv .venv

Esto crea una carpeta llamada .venv, donde quedarán instaladas las librerías del proyecto.

7. Activar el entorno virtual

En PowerShell, ejecutar:

.\.venv\Scripts\Activate.ps1

Cuando el entorno virtual esté activo, la terminal mostrará algo parecido a:

(.venv) PS C:\Proyectos\design>

Si PowerShell bloquea la activación, ejecutar una sola vez:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Luego cerrar y abrir de nuevo la terminal de VSCode, y volver a activar:

.\.venv\Scripts\Activate.ps1

8. Seleccionar el intérprete de Python en VSCode

En VSCode:

Ctrl + Shift + P

Buscar:

Python: Select Interpreter

Seleccionar el intérprete que esté dentro de:

C:\Proyectos\design\.venv\Scripts\python.exe

VSCode permite seleccionar el entorno de Python del proyecto desde la paleta de comandos o desde sus herramientas de entornos de Python. (Visual Studio Code)

9. Instalar las dependencias del proyecto

Con el entorno virtual activo, ejecutar:

python -m pip install --upgrade pip

Luego instalar las librerías del proyecto:

pip install -r requirements.txt

o, de forma equivalente:

python -m pip install -r requirements.txt

10. Ejecutar la aplicación Streamlit

Con el entorno virtual activo y estando dentro de la carpeta del proyecto, ejecutar:

streamlit run app.py

Streamlit es un framework de Python para construir aplicaciones interactivas de datos, y su ejecución básica se realiza con comandos como streamlit run. (Streamlit)

La aplicación se abrirá en el navegador. Normalmente aparecerá en una dirección local como:

http://localhost:8501

Resumen de comandos principales

cd C:\
mkdir Proyectos
cd Proyectos

git clone https://github.com/justorfc/design.git
cd design

code .

python -m venv .venv
.\.venv\Scripts\Activate.ps1

python -m pip install --upgrade pip
pip install -r requirements.txt

streamlit run app.py

Cómo actualizar el proyecto si el profesor hace cambios

Cuando el profesor actualice el repositorio, cada estudiante puede traer los cambios con:

cd C:\Proyectos\design
git pull

Nota importante para los estudiantes

Clonar el repositorio permite descargar y ejecutar la aplicación en el computador personal. Sin embargo, los estudiantes no podrán subir cambios directamente al repositorio del profesor, salvo que el profesor les dé permisos.

Para el proyecto final, cada grupo puede:

  1. Clonar este repositorio como base.
  2. Hacer sus mejoras.
  3. Crear un repositorio propio en GitHub.
  4. Subir allí su versión final de la aplicación.

Mensaje breve para publicar en Microsoft Teams

Puede compartir este texto con ellos:

Estimados estudiantes, para el proyecto de la App de Diseño Experimental deberán clonar en sus computadores el repositorio base desde GitHub:

https://github.com/justorfc/design.git

La recomendación es clonarlo en C:\Proyectos, abrirlo con VSCode, crear un entorno virtual de Python, instalar las dependencias con pip install -r requirements.txt y ejecutarlo con streamlit run app.py.

Esta app será la base para que cada grupo estudie, modifique, mejore y amplíe el aplicativo como parte del proyecto final de la asignatura.