Cómo crear y activar un entorno virtual en Python

Crear un entorno virtual en Python es el primer paso para aislar las dependencias de cada proyecto y evitar que las librerías de una aplicación choquen con otra. Aquí aprenderás a crearlo, activarlo, instalar paquetes y compartir esas dependencias con otros desarrolladores usando comandos concretos. Es ideal si estás empezando a programar en Python y quieres orden desde el inicio.

Cómo confirmo que Python está instalado antes de empezar?

Antes de crear cualquier entorno, conviene verificar qué versión de Python tienes y desde dónde se ejecuta. Esto importa porque vas a manejar varios ejecutables al mismo tiempo y necesitas saber cuál estás usando.

Con python --version confirmas que Python está instalado y ves la versión. Con which python descubres la ruta del ejecutable. En este caso, python es un alias que apunta a python3, y al ejecutar which python3 aparece la ruta real, que aquí viene de Homebrew, el manejador de paquetes usado en Mac para instalar Python 3.

Para qué sirve el comando which en Python? Muestra la ruta exacta del ejecutable que estás usando. Es clave cuando tienes varios Python instalados y necesitas saber cuál se activa. [00:15]

Cómo creo y activo un entorno virtual con venv?

El módulo venv viene incluido con Python y genera una carpeta aislada para tu proyecto. Aquí está lo interesante: cada entorno nace limpio, sin paquetes previos.

Para crearlo ejecutas python -m venv newsenv, donde -m indica que llamas a un módulo, venv significa virtual environment y newsenv es el nombre que le das (en este caso pensando en una aplicación de noticias). Al presionar enter, se crea la carpeta del entorno. Visual Studio Code incluso te pregunta si quieres seleccionarlo automáticamente.

Para activarlo usas el comando source seguido de la ruta al script de activación:

bash source newsenv/bin/activate

Después de activarlo, si ejecutas which python3 verás que ya no apunta a Homebrew, sino a la carpeta de tu proyecto (newsenv). Esa es la señal de que el entorno está funcionando. Para salir, basta con escribir deactivate y volverás al Python original del sistema.

Cómo activo un entorno virtual en Python? Usa source nombre_entorno/bin/activate en Linux o Mac. Para desactivarlo, escribe deactivate. [03:00]

Qué contiene la carpeta del entorno virtual?

Cuando abres la carpeta creada, encuentras una estructura clara con varios elementos:

• Una carpeta bin con los ejecutables de Python, los ejecutables de pip y cuatro scripts de activación (uno para Linux y otros para Windows).
• Una carpeta include con archivos que se agregan al hacer pip install.
• Una carpeta lib que al inicio solo tiene pip instalado, porque el entorno nace limpio.
• Un archivo de configuración con el home y la versión de Python que se usan al ejecutar.

Esta separación es lo que te permite instalar distintas versiones de librerías por proyecto sin conflictos.

Cómo instalo y comparto dependencias con pip?

Las dependencias son las librerías externas que tu proyecto necesita para funcionar. Para encontrarlas existe PyPI, la plataforma que lista todos los paquetes disponibles del ecosistema Python.

Al buscar Ruff, la herramienta que formatea código, ves su última versión y el comando exacto de instalación. Lo instalas con pip install ruff, que descarga el paquete desde PyPI. Luego, con pip list compruebas todos los paquetes instalados dentro de tu entorno.

Y aquí viene lo importante para trabajar en equipo: necesitas compartir esas mismas versiones. Para eso creas un archivo requirements.txt con el resultado de pip freeze, que devuelve cada dependencia con su versión fijada usando dos iguales (por ejemplo ruff==0.x.x).

Qué es el archivo requirements.txt? Es un archivo que lista las dependencias del proyecto con sus versiones exactas. Otra persona las instala todas con pip install -r requirements.txt. [06:30]

Para instalar desde ese archivo, cualquier desarrollador ejecuta pip install -r requirements.txt. Si necesitas quitar una librería, usas pip uninstall con el nombre del paquete. Fijar las versiones evita que una actualización inesperada de una librería dañe tu aplicación.

Por qué no debo subir el entorno virtual al repositorio?

La carpeta del entorno virtual vive solo en tu computador y no debe compartirse en el repositorio. Lo que se comparte es el archivo de requerimientos, no los archivos pesados del entorno.

Por eso debes agregar la carpeta del entorno al archivo gitignore. Así cada persona genera su propio entorno a partir del requirements.txt, manteniendo las mismas versiones sin cargar el repositorio con archivos innecesarios.

Puntos clave para mantener orden en tus proyectos:

• Nunca subas la carpeta del entorno virtual al repositorio.
• Agrega siempre esa carpeta al gitignore.
• Mantén las versiones fijadas en requirements.txt para proteger tu aplicación.

Cuando trabajas con un IDE como Visual Studio Code, extensiones como Python Environments te muestran con un icono en qué entorno estás y la lista de dependencias activas, lo que reduce el riesgo de confundir entornos.

Como reto final, busca la librería python-dotenv, que te permite sacar la API key del archivo de configuración y protegerla de cualquier uso inadecuado. ¿Te animas a probarla en tu propio proyecto? Cuéntame en los comentarios cómo te fue.