3- Creando tu Primer Entorno Virtual Python con Flask
🎯 Tema del Tutorial: "Tu Primer Entorno de Programación Python: Entornos Virtuales y Flask"
Índice Visual
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:
1. Python 🐍 - El "motor" de nuestro programa
2. Visual Studio Code 💻 - El "taller" donde trabajamos
3. Flask 🌐 - El "marco" para construir aplicaciones webAnalogí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 Virtual | Con 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:
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 + Flask3. INSTALANDO VISUAL STUDIO CODE 💻
Pasos para Instalar:
Paso 1: Descargar
🔗 https://code.visualstudio.com/
Click en "Download for Windows"Paso 2: Instalar
Doble click en el instalador → Siguiente → Siguiente → InstalarPaso 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
🔗 https://www.python.org/downloads/
Click en "Download Python"Paso 2: Instalación IMPORTANTE:
✅ MARCAR ESTA OPCIÓN: "Add Python to PATH"Esto es CRUCIAL para que Python funcione correctamente.
Paso 3: Verificar Instalación:
Abre PowerShell o CMD
Escribe:
python --versionDeberías ver algo como:
Python 3.12.1
Diagrama de Instalación Correcta:
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
# 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-appPaso 2: Crear Entorno Virtual
# 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:
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:
No se puede cargar el archivo... la ejecución de script está deshabilitadaSolución Paso a Paso:
Paso 1: Cambiar Política de Ejecución
# En PowerShell como Administrador
Set-ExecutionPolicy RemoteSignedPaso 2: Responder la pregunta:
¿Quieres cambiar la directiva de ejecución?
[5] Si [T] No a todo [N] No [U] SuspenderPresiona: 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
# 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:
(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:
| Paso | Comando | Resultado Esperado |
|---|---|---|
| 1. Python instalado | python --version | Muestra versión (ej: 3.12.1) |
| 2. En entorno virtual | Mira el prompt | Debe mostrar (venv) al inicio |
| 3. VS Code funcionando | Abre carpeta | Debe 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:
# 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\activateError 3: Permisos en PowerShell
Solución: Ejecuta PowerShell como Administrador
8. FLUJO COMPLETO RESUMIDO 📋
Resumen en 5 Pasos:
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.ps1Comandos para Copiar y Pegar:
# 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.ps19. ¿QUÉ SIGUE? 🚀
Próximos Pasos:
Instalar Flask en el entorno virtual
Crear tu primera app web
Conectar con Ollama
Desplegar tu aplicación
Flujo de Aprendizaje:
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
Publicar un comentario