Guía para Instalación y Configuración: Git, Python, VsCode y Streamlit

Esta guía está diseñada para estudiantes sin experiencia previa en programación. Cada paso incluye una breve explicación para que comprendan qué están haciendo y por qué es importante.

Parte 1: Preparación y Creación de Cuenta en GitHub

Objetivo: Crear una cuenta en GitHub, la plataforma donde se alojará el código y desde donde se desplegará la aplicación.

  1. Crear una cuenta en GitHub:
    • Abre tu navegador y ve a github.com.
    • Haz clic en el botón “Sign up” (Registrarse) en la esquina superior derecha .
    • Sigue las instrucciones: ingresa un correo electrónico válido, una contraseña segura y un nombre de usuario.
    • Completa la verificación y haz clic en “Create account”. Revisa tu correo para verificar la dirección.

    Explicación: GitHub es un servicio de hosting para proyectos de software que utiliza Git para el control de versiones. Es donde se almacenará el código de las aplicaciones de forma segura .

Parte 2: Instalación del Entorno de Desarrollo (Git, Python, VsCode)

Objetivo: Instalar las herramientas fundamentales: Git (control de versiones), Python (el lenguaje de programación) y VsCode (el editor de código).

  1. Descargar e instalar Git:
    • Ve al sitio web oficial de Git: git-scm.com/download/win.
    • La descarga debería comenzar automáticamente. Ejecuta el archivo .exe descargado .
    • Durante la instalación, deja todas las opciones por defecto y haz clic en “Siguiente” o “Next” hasta finalizar .
    • Explicación: Git es el sistema que permite rastrear los cambios en el código y subirlo a GitHub.
  2. Descargar e instalar Python:
    • Ve al sitio web oficial de Python: python.org/downloads/.
    • Haz clic en el botón amarillo “Download Python” para Windows .
    • IMPORTANTE: En la primera pantalla del instalador, marca la casilla que dice “Add python.exe to PATH” (Agregar Python al PATH). Esto es fundamental para que VsCode y la terminal puedan encontrar Python.
    • Luego, haz clic en “Install Now” y espera a que finalice la instalación .
    • Explicación: Python es el intérprete que ejecutará el código de las aplicaciones. Agregarlo al PATH permite usarlo desde cualquier lugar del sistema.
  3. Descargar e instalar Visual Studio Code (VsCode):
    • Ve al sitio web oficial de VsCode: code.visualstudio.com/download.
    • Descarga el instalador para Windows (sistema de 64 bits) .
    • Ejecuta el instalador y, al igual que con Git, deja todas las opciones por defecto y haz clic en “Siguiente” o “Next”.
    • Explicación: VsCode es un editor de código moderno y ligero, muy popular en el mundo de la ciencia de datos y Python. Ofrece muchas extensiones que facilitan el trabajo.
  4. Verificar las instalaciones:
    • Presiona la tecla de Windows, escribe PowerShell y abre “Windows PowerShell”.
    • Para confirmar que todo se instaló correctamente, escribe cada uno de los siguientes comandos y presiona Enter: powershell python --version git --version code --version
    • Explicación: Cada comando debería mostrar el número de la versión instalada. Si aparece un error, significa que la instalación no fue exitosa y se debe repetir el paso correspondiente .

Parte 3: Configuración de Git y Conexión con GitHub

Objetivo: Decirle a Git quién eres (tu nombre y correo) y vincular tu computadora con tu cuenta de GitHub.

  1. Configurar el nombre de usuario y correo electrónico global:
    • En la misma ventana de PowerShell, escribe los siguientes comandos, reemplazando con tu nombre y el correo que usaste en GitHub: powershell git config --global user.name "Tu Nombre Completo" git config --global user.email "tu_correo@ejemplo.com"
    • Explicación: Esto es importante para que cada cambio que hagas en el código quede identificado con tu nombre .
  2. Crear un Token de Acceso Personal (PAT) en GitHub (Recomendado):
    • Ve a GitHub.com e inicia sesión.
    • Haz clic en tu foto de perfil (arriba a la derecha) y ve a Settings.
    • En el menú de la izquierda, baja hasta Developer settings.
    • Luego, haz clic en Personal access tokens > Tokens (classic).
    • Haz clic en “Generate new token” y luego en “Generate new token (classic)”.
    • Dale un nombre al token, por ejemplo, MiPC.
    • En “Expiration”, puedes elegir una fecha de expiración (por ejemplo, 90 días).
    • En “Select scopes”, marca la casilla repo (para control total de los repositorios privados).
    • Desplázate hasta abajo y haz clic en “Generate token”.
    • IMPORTANTE: Copia el token que aparece (es una cadena larga de letras y números). Es la única vez que lo verás. Guárdalo en un lugar seguro.
    • Explicación: GitHub ya no permite usar la contraseña de la cuenta para subir código desde la terminal. El Token funciona como una contraseña segura y específica para este propósito .

Parte 4: Creación del Repositorio en GitHub

Objetivo: Crear un espacio (“repositorio” o “repo”) en la nube donde se almacenará el proyecto.

  1. Crear un nuevo repositorio:
    • Estando en GitHub.com, haz clic en el signo “+” en la esquina superior derecha y selecciona “New repository” .
    • En “Repository name”, escribe un nombre para tu proyecto, por ejemplo, mi-primera-app.
    • Asegúrate de que esté en “Public” (público). Los repositorios públicos son gratuitos y necesarios para el despliegue en Streamlit Community Cloud .
    • No marques ninguna casilla (como “Add a README file”).
    • Haz clic en “Create repository” .
    • Explicación: El repositorio es la carpeta principal del proyecto en GitHub. Al crearlo vacío, tendrás la URL para vincularlo con tu computadora.

Parte 5: Configuración de VsCode y Primer Proyecto

Objetivo: Abrir el proyecto en VsCode y configurarlo para que funcione con Python.

  1. Instalar la extensión de Python en VsCode:
    • Abre VsCode.
    • En la barra lateral izquierda, haz clic en el ícono de Extensiones (cuatro cuadrados, uno separado).
    • En la barra de búsqueda, escribe Python.
    • Localiza la extensión publicada por Microsoft y haz clic en “Install” .
    • Explicación: Esta extensión convierte a VsCode en un entorno de desarrollo completo para Python, añadiendo resaltado de sintaxis, autocompletado y otras herramientas útiles.
  2. Crear una carpeta para el proyecto y abrirla:
    • Crea una nueva carpeta en tu computadora, por ejemplo, en el Escritorio o en Documentos, con el nombre mi-primera-app.
    • En VsCode, ve al menú File > Open Folder… y selecciona la carpeta que acabas de crear.
    • Haz clic en “Select Folder”.
    • Explicación: VsCode trabaja con “proyectos” basados en carpetas. Al abrir la carpeta, todo lo que hagas dentro de VsCode estará contenido en ella.

Parte 6: Creación y Activación del Entorno Virtual (Venv)

Objetivo: Crear un “espacio aislado” para las librerías de Python de este proyecto, evitando conflictos con otros proyectos.

  1. Abrir la terminal integrada en VsCode:
    • Ve al menú Terminal > New Terminal.
    • Se abrirá una ventana en la parte inferior de VsCode. Asegúrate de que diga PowerShell.
  2. Crear el entorno virtual:
    • En la terminal de VsCode, escribe el siguiente comando y presiona Enter: powershell python -m venv .venv
    • Explicación: Este comando crea una carpeta oculta llamada .venv dentro de tu proyecto. Allí se instalarán todas las librerías (como Streamlit) de manera aislada .
  3. Activar el entorno virtual:
    • Ahora, escribe el siguiente comando en la terminal y presiona Enter: powershell .venv\Scripts\Activate.ps1
    • Explicación: La terminal ahora mostrará (.venv) al principio de la línea. Esto indica que el entorno virtual está activo y cualquier librería que se instale se guardará aquí .
    • Posible error: Si ves un mensaje de error sobre la política de ejecución, ejecuta este comando una sola vez y luego repite el de activación: powershell Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned > Explicación: Este comando le da permiso a PowerShell para ejecutar scripts, como el de activación .

Parte 7: Instalación de Streamlit y Creación de la Primera App

Objetivo: Instalar la librería Streamlit y escribir el código de una aplicación de prueba.

  1. Instalar Streamlit:
    • Con el entorno virtual activo (debes ver (.venv)), escribe en la terminal: powershell pip install streamlit
    • Espera a que termine la instalación. Puede tardar un par de minutos.
    • Explicación: pip es el gestor de paquetes de Python. streamlit es la librería que permite crear aplicaciones web interactivas con solo código Python .
  2. Crear el archivo de la aplicación (app.py):
    • En el panel izquierdo de VsCode (el Explorador de archivos), haz clic en el ícono de “Nuevo Archivo”.
    • Nómbralo app.py.
    • Explicación: Este será el archivo principal de la aplicación. Por convención, suele llamarse app.py o streamlit_app.py.
  3. Escribir el código de prueba:

    • Copia y pega el siguiente código en el archivo app.py: ```python import streamlit as st

      st.title(“¡Mi primera app con Streamlit!”) st.write(“Hola, estudiantes de Ingeniería Agrícola.”) st.write(“Este es un ejemplo de una aplicación desplegada en Streamlit Cloud.”) ```

    • Explicación: Este código importa la librería Streamlit, le asigna el alias st, y luego usa sus funciones para mostrar texto en la página web .

  4. Ejecutar la aplicación localmente:
    • En la terminal de VsCode (con el entorno virtual activo), ejecuta: powershell streamlit run app.py
    • Después de unos segundos, se abrirá automáticamente una nueva pestaña en tu navegador con la aplicación .
    • Explicación: streamlit run es el comando que inicia el servidor de desarrollo de Streamlit para mostrar la aplicación.
  5. Detener la aplicación:
    • Para detener la aplicación y volver a la terminal, ve a la ventana de la terminal y presiona Ctrl + C.
    • Explicación: Esto detiene el servidor local. Es importante hacerlo antes de cerrar VsCode o subir el código a GitHub.

Parte 8: Subir el Código a GitHub desde VsCode

Objetivo: Guardar el código de la aplicación en el repositorio de GitHub usando las herramientas integradas de VsCode.

  1. Inicializar el repositorio Git en la carpeta del proyecto:
    • En VsCode, ve al ícono de Control de código fuente en la barra lateral izquierda (parece un diagrama de ramas con un número).
    • Haz clic en el botón “Inicializar repositorio” (Initialize Repository) .
    • Explicación: Esto crea un repositorio Git local (una carpeta oculta .git) dentro de tu proyecto para empezar a rastrear los cambios.
  2. Crear el archivo .gitignore:
    • Crea un nuevo archivo en VsCode y nómbralo exactamente .gitignore.
    • Escribe la siguiente línea dentro del archivo y guárdalo: .venv/
    • Explicación: El archivo .gitignore le dice a Git qué archivos o carpetas no debe subir a GitHub. La carpeta .venv es muy grande y contiene archivos específicos de tu computadora; no debe subirse .
  3. Preparar (Stage) y Confirmar (Commit) los cambios:
    • En el panel de Control de código fuente, verás los archivos app.py y .gitignore listados.
    • Escribe un mensaje en el campo de texto en la parte superior (ej. "Primer commit: app de prueba").
    • Haz clic en la marca de verificación (✓) “Commit” (o presiona Ctrl+Enter).
    • Explicación: “Stage” significa preparar los archivos para ser guardados en el historial de Git. “Commit” es como tomar una foto de los archivos en ese momento, creando un punto en el historial del proyecto .
  4. Sincronizar (Push) el código con GitHub:
    • Ve a la barra de estado en la parte inferior izquierda de VsCode. Deberías ver un ícono de una nube con una flecha o un círculo que dice “Publicar en GitHub”.
    • Haz clic en “Publicar rama” (Publish Branch) o ve al menú de Control de código fuente y haz clic en los tres puntos (…) > “Push”.
    • VsCode te pedirá que autorices la conexión con GitHub. Sigue las instrucciones en el navegador.
    • Te pedirá el nombre del repositorio remoto. Selecciona el que creaste en GitHub (mi-primera-app).
    • Explicación: “Push” es el comando que sube los commits locales a GitHub. Al hacerlo, el código estará disponible en la nube .
  5. Verificar:
    • Actualiza la página de tu repositorio en GitHub. Deberías ver los archivos app.py y .gitignore.

Parte 9: Despliegue en Streamlit Community Cloud

Objetivo: Hacer que la aplicación sea pública y accesible para cualquier persona a través de un enlace, usando el servicio gratuito de Streamlit .

  1. Acceder a Streamlit Community Cloud:
    • Ve a share.streamlit.io en tu navegador.
    • Haz clic en “Continue with GitHub” .
    • Autoriza a Streamlit para que acceda a tu cuenta de GitHub.
    • Explicación: Streamlit Cloud se conecta directamente a tus repositorios de GitHub para desplegar aplicaciones .
  2. Desplegar una nueva aplicación:
    • En el dashboard de Streamlit, haz clic en el botón “New app” (o “Create App”) .
    • En el formulario de despliegue, selecciona:
      • Repository: tu-usuario/mi-primera-app
      • Branch: main
      • Main file path: app.py
    • Haz clic en “Deploy” .
    • Explicación: Streamlit Cloud buscará el archivo app.py en el repositorio, instalará las dependencias (como Streamlit) y pondrá la aplicación en línea.
  3. Esperar el despliegue y probar:
    • El proceso de despliegue tomará unos minutos. Puedes ver los logs para rastrear el progreso.
    • Una vez finalizado, Streamlit te proporcionará una URL, algo como https://tu-usuario-mi-primera-app.streamlit.app.
    • Haz clic en la URL para ver tu aplicación en vivo.
    • Explicación: La aplicación ahora está disponible públicamente. Cualquier persona con el enlace puede acceder a ella .
  4. Actualizaciones automáticas:
    • Si realizas cambios en el código (app.py), los subes a GitHub con un commit y un push. Streamlit Cloud detectará automáticamente el cambio y desplegará la nueva versión .

Resumen para el Video

  1. Creación de la cuenta en GitHub (github.com).
  2. Instalación de Git, Python y VsCode (usando todos los ajustes predeterminados, con especial atención a la opción “Add Python to PATH”).
  3. Configuración de Git (nombre y correo).
  4. Creación del repositorio en GitHub (vacío y público).
  5. Configuración de VsCode (instalación de la extensión de Python y apertura de la carpeta del proyecto).
  6. Creación y activación del entorno virtual (venv) dentro de VsCode.
  7. Instalación de Streamlit en el entorno virtual.
  8. Creación del archivo app.py con el código de prueba.
  9. Ejecución local de la aplicación.
  10. Subida del código a GitHub (inicializar repositorio, agregar .gitignore, hacer commit y push).
  11. Despliegue en Streamlit Cloud (conectar con GitHub y seleccionar el repositorio y archivo principal).