3- Creando tu Primer Entorno Virtual Python con Flask

 https://docs.google.com/presentation/d/e/2PACX-1vTygk-5apLh_TrGm0qH-RDWmpKchPG0CnHqZah8f6wyia4wvJ2liPdqwUsib6T6dvUWMnNsLvz30Ppy/pub?start=false&loop=false&delayms=3000

🎯 Tema del Tutorial: "Tu Primer Entorno de Programación Python: Entornos Virtuales y Flask"

Índice Visual

text
1. PREPARANDO LAS HERRAMIENTAS 🔧
   │
2. ¿QUÉ ES UN ENTORNO VIRTUAL? 🎪
   │
3. INSTALANDO VISUAL STUDIO CODE 💻
   │
4. INSTALANDO PYTHON 🐍
   │
5. CREANDO TU PRIMER ENTORNO VIRTUAL ⚡
   │
6. SOLUCIONANDO PROBLEMAS COMUNES 🛠️
   │
7. PRÓXIMOS PASOS 🚀

1. PREPARANDO LAS HERRAMIENTAS 🔧

Las 3 Herramientas Esenciales:

text
1. Python 🐍 - El "motor" de nuestro programa
2. Visual Studio Code 💻 - El "taller" donde trabajamos
3. Flask 🌐 - El "marco" para construir aplicaciones web

Analogía del Carpintero:

  • Python = Las herramientas (martillo, sierra)

  • VS Code = El taller de trabajo

  • Flask = Los planos para construir una mesa

  • Entorno Virtual = Una caja de herramientas separada para cada proyecto


2. ¿QUÉ ES UN ENTORNO VIRTUAL? 🎪

Explicación Simple:

Un entorno virtual es como tener "habitaciones separadas" para cada proyecto de Python.

¿Por qué necesitamos esto?

Sin Entorno VirtualCon Entorno Virtual
🚫 Todas las bibliotecas se mezclan✅ Cada proyecto tiene sus propias bibliotecas
🚫 Conflictos entre versiones✅ Versiones específicas para cada proyecto
🚫 Difícil de manejar✅ Fácil de compartir y reproducir

Esquema Visual:

text
TU COMPUTADORA:
├── Proyecto 1 (venv1) 🎮
│   ├── Python 3.10
│   └── Flask 2.3
│
├── Proyecto 2 (venv2) 📊
│   ├── Python 3.11
│   └── Flask 3.0
│
└── Proyecto 3 (venv3) 🤖
    ├── Python 3.9
    └── Ollama + Flask

3. INSTALANDO VISUAL STUDIO CODE 💻

Pasos para Instalar:

Paso 1: Descargar

text
🔗 https://code.visualstudio.com/
Click en "Download for Windows"

Paso 2: Instalar

text
Doble click en el instalador → Siguiente → Siguiente → Instalar

Paso 3: Configuración Básica:

  • Acepta todos los valores por defecto

  • No necesitas configuraciones especiales

  • ¡Listo para usar!

💡 Consejo:

VS Code es GRATIS y es una de las herramientas más populares para programar.


4. INSTALANDO PYTHON 🐍

Pasos para Instalar:

Paso 1: Descargar

text
🔗 https://www.python.org/downloads/
Click en "Download Python"

Paso 2: Instalación IMPORTANTE:

text
✅ MARCAR ESTA OPCIÓN: "Add Python to PATH"

Esto es CRUCIAL para que Python funcione correctamente.

Paso 3: Verificar Instalación:

  1. Abre PowerShell o CMD

  2. Escribe: python --version

  3. Deberías ver algo como: Python 3.12.1

Diagrama de Instalación Correcta:

text
Instalador de Python:
├── [✅] Install launcher for all users
├── [✅] Add Python to PATH  ← ¡IMPORTANTE!
├── [ ] Customize installation
└── Click "Install Now"

5. CREANDO TU PRIMER ENTORNO VIRTUAL ⚡

Paso 1: Crear Carpeta del Proyecto

powershell
# Abre PowerShell como administrador
# Navega a tu carpeta de proyectos
cd D:\
mkdir Python_Projects
cd Python_Projects
mkdir ollama-flask-app
cd ollama-flask-app

Paso 2: Crear Entorno Virtual

powershell
# Comando mágico para crear entorno virtual
python -m venv venv

¿Qué significa esto?

  • python: Llama a Python

  • -m venv: Usa el módulo "venv" (virtual environment)

  • venv: Nombre de la carpeta que se creará (puede ser cualquier nombre)

Esquema de lo que se crea:

text
ollama-flask-app/
├── venv/           ← Tu entorno virtual
│   ├── Scripts/    ← Archivos ejecutables
│   ├── Lib/        ← Bibliotecas instaladas
│   └── Include/    ← Archivos de cabecera
└── (tus archivos futuros)

6. ACTIVANDO EL ENTORNO VIRTUAL ⚡

El Problema Común:

Cuando intentas activar el entorno, aparece este error:

text
No se puede cargar el archivo... la ejecución de script está deshabilitada

Solución Paso a Paso:

Paso 1: Cambiar Política de Ejecución

powershell
# En PowerShell como Administrador
Set-ExecutionPolicy RemoteSigned

Paso 2: Responder la pregunta:

text
¿Quieres cambiar la directiva de ejecución?
[5] Si  [T] No a todo  [N] No  [U] Suspender

Presiona: S (para Sí)

¿Por qué esto es necesario?

Windows bloquea scripts por seguridad. Esta política permite scripts firmados (como los de Python) pero bloquea scripts desconocidos.

Paso 3: Activar el Entorno

powershell
# Navega a tu carpeta del proyecto
cd D:\Python_Projects\ollama-flask-app

# Activa el entorno virtual
.\venv\Scripts\Activate.ps1

🎉 ¡Éxito! Deberías ver:

powershell
(venv) PS D:\Python_Projects\ollama-flask-app>

El (venv) al principio significa que estás dentro del entorno virtual.


7. VERIFICACIÓN Y TROUBLESHOOTING 🛠️

Tabla de Verificación:

PasoComandoResultado Esperado
1. Python instaladopython --versionMuestra versión (ej: 3.12.1)
2. En entorno virtualMira el promptDebe mostrar (venv) al inicio
3. VS Code funcionandoAbre carpetaDebe mostrar archivos correctamente

Errores Comunes y Soluciones:

Error 1: "python no se reconoce como comando"

Solución: Reinstalar Python marcando "Add Python to PATH"

Error 2: No aparece (venv)

Solución:

powershell
# Verifica que estás en la carpeta correcta
cd D:\Python_Projects\ollama-flask-app

# Lista archivos para ver si existe venv
dir

# Si existe, activa manualmente
.\venv\Scripts\activate

Error 3: Permisos en PowerShell

Solución: Ejecuta PowerShell como Administrador


8. FLUJO COMPLETO RESUMIDO 📋

Resumen en 5 Pasos:

text
1. 📥 Instalar Python (marcar "Add to PATH")
2. 📥 Instalar VS Code
3. 📁 Crear carpeta del proyecto
4. 🎪 Crear entorno: python -m venv venv
5. ⚡ Activar: .\venv\Scripts\Activate.ps1

Comandos para Copiar y Pegar:

powershell
# 1. Crear entorno virtual
python -m venv venv

# 2. Si hay error de permisos (en PowerShell como Admin)
Set-ExecutionPolicy RemoteSigned
# Presionar S

# 3. Activar entorno
.\venv\Scripts\Activate.ps1

9. ¿QUÉ SIGUE? 🚀

Próximos Pasos:

  1. Instalar Flask en el entorno virtual

  2. Crear tu primera app web

  3. Conectar con Ollama

  4. Desplegar tu aplicación

Flujo de Aprendizaje:

text
Día 1: Instalar herramientas ← (¡ESTÁS AQUÍ!)
Día 2: Aprender Python básico
Día 3: Instalar Flask y crear primera página
Día 4: Conectar con Ollama
Día 5: Crear interfaz web completa

📝 CUESTIONARIO DE REPASO

Pregunta 1:

¿Qué es un entorno virtual en Python?
a) Una computadora virtual
b) Un sistema operativo separado
c) Un espacio aislado para cada proyecto con sus propias bibliotecas
d) Un programa para hacer gráficos 3D

Respuesta correcta: c) Un entorno virtual es un espacio aislado donde cada proyecto tiene sus propias versiones de bibliotecas, evitando conflictos.


Pregunta 2:

Al instalar Python, ¿qué opción DEBES marcar para que funcione correctamente?
a) Install for all users
b) Add Python to PATH
c) Create shortcuts
d) Precompile standard library

Respuesta correcta: b) "Add Python to PATH" es CRUCIAL para que puedas usar Python desde cualquier carpeta en la terminal.


Pregunta 3:

¿Qué comando usas para crear un entorno virtual llamado "venv"?
a) python create venv
b) python -m venv venv
c) venv create python
d) pip install venv

Respuesta correcta: b) python -m venv venv - El primer "venv" es el módulo, el segundo es el nombre de la carpeta.


Pregunta 4:

Cuando activas correctamente el entorno virtual, ¿qué aparece en la terminal?
a) Un mensaje de éxito
b) La palabra (venv) al inicio del prompt
c) Un check verde
d) Una nueva ventana

Respuesta correcta: b) Deberías ver (venv) al principio de la línea de comandos, indicando que estás dentro del entorno virtual.


Pregunta 5:

Si recibes el error "la ejecución de script está deshabilitada", ¿qué comando soluciona esto?
a) Enable-ScriptExecution
b) Set-ExecutionPolicy RemoteSigned
c) Allow-PowerShellScripts
d) Fix-PermissionError

Respuesta correcta: b) Set-ExecutionPolicy RemoteSigned cambia la política para permitir scripts firmados.


Pregunta 6:

¿Cómo verificas que Python está instalado correctamente?
a) python --help
b) python --version
c) check python
d) python status

Respuesta correcta: b) python --version muestra la versión instalada, confirmando que Python funciona.


Pregunta 7:

¿Qué significa el símbolo .\ al principio de .\venv\Scripts\Activate.ps1?
a) "Ejecutar desde la carpeta actual"
b) "Buscar en todo el sistema"
c) "Ejecutar como administrador"
d) "Crear nuevo archivo"

Respuesta correcta: a) .\ significa "en la carpeta actual", indicando que el archivo está en la misma carpeta donde estás.


🎉 ¡Felicidades!

Has completado la instalación de tu entorno de desarrollo. Ahora tienes:

  • ✅ Python instalado y configurado

  • ✅ VS Code listo para programar

  • ✅ Tu primer entorno virtual creado

  • ✅ Solucionado problemas comunes de permisos

Recuerda: Cada vez que trabajes en este proyecto, activa el entorno virtual primero. ¡Estás listo para empezar a programar con Flask y Ollama!

Comentarios

Entradas más populares de este blog

1-Instalación y Primeros Pasos con Ollama

2- Cómo Usar Ollama con Postman (APIs y Comunicación)