Clona un proyecto de GitHub y crea tu entorno virtual en VSCode paso a paso

▶

Te voy a explicar cómo puedes descargar un proyecto en Python desde tu GitHub para que puedas desarrollarlo mediante un ambiente virtual. Es decir, vamos a configurar el entorno, descargar el proyecto e instalar sus dependencias.

Requisitos previos

1. Primero: este es un proyecto privado, pero eso da igual. Los pasos son los mismos si es público o privado.
2. Segundo: estoy dando por hecho que ya tienes Git configurado en tu terminal. No lo explicaré aquí, me enfoco únicamente en los pasos para clonar el proyecto y configurar el entorno virtual.

Verifica tu versión de Python

Un pequeño detalle extra: yo tenía una versión antigua de Python en mi Mac y tuve que grabar este video dos veces. Cuando intentaba instalar las versiones específicas requeridas por el proyecto, me decía que no se podían instalar porque Python estaba desactualizado.
El proyecto requiere Django 5, así que debes asegurarte de tener una versión de Python compatible.

Si no sabes cómo actualizarlo, te dejo un video que explica cómo hacerlo.

Instalación de dependencias globales mínimas

En este ejemplo voy a usar venv. Como puedes ver, al actualizar Python, ya no tengo paquetes instalados a nivel global. En mi caso, tengo que usar pip3 para instalar paquetes, aunque normalmente bastaría con pip. Eso depende de tu sistema operativo... cosas de Dios.

Entonces, instalo virtualenv con:

$ pip3 install virtualenv

Este será el único paquete que instalaremos a nivel global del sistema operativo. Todo lo demás debe instalarse dentro del entorno virtual del proyecto.

Puedes comprobar que está instalado con:

$ pip3 freeze

Y verás que aparece únicamente virtualenv.

Preparar la carpeta del proyecto

Ahora cerramos esta terminal y nos aseguramos de tener una carpeta vacía donde vamos a trabajar. En mi caso, la carpeta se llama cursos. Ahí se va a colocar el entorno virtual y luego el proyecto clonado.

Si manejas múltiples proyectos, te recomiendo crear una carpeta por proyecto. En mi caso, lo haré todo aquí.

Crear el entorno virtual desde VS Code

Abrimos una nueva instancia de VS Code. Para evitar conflictos, recomiendo crear el entorno desde VS Code, ya que así reconoce mejor los paquetes y activa el autocompletado.

Además, asegúrate de tener instalada la extensión de Python de Microsoft.

Luego presiona:

Ctrl+Shift+P (o Cmd+Shift+P en Mac)

Busca y selecciona Python: Create Environment.

Selecciona la carpeta del proyecto (en mi caso cursos) y luego la versión de Python que deseas usar (usa la nueva, no la antigua).

VS Code creará el entorno en esa carpeta. Si te aparece entre paréntesis el nombre del entorno en la terminal, significa que se activó correctamente. Si no, puede que debas activarlo manualmente.

Una forma infalible de verificar que estás en el entorno virtual es ejecutar:

$ pip3 freeze

Y comprobar que solo aparece lo que esté instalado en ese entorno (por ejemplo, virtualenv). Si aparece más, probablemente estás usando el entorno global.

Clonar el proyecto desde GitHub

Ahora sí, vamos a clonar el repositorio. Recuerda que ya tienes Git configurado. Abre la terminal y ejecuta:

$ git clone https://github.com/usuario/repositorio.git

Renombra la carpeta si lo deseas (en mi caso la renombré a django-shopping).

Instalar dependencias del proyecto

Una vez clonado el proyecto, navega dentro de su carpeta:

$ cd django-shopping

Y luego instala las dependencias usando el archivo requirements.txt:

$ pip3 install -r requirements.txt

Esto instalará exactamente las versiones necesarias para el proyecto.

Verifica una vez más con pip3 freeze que ahora sí están las dependencias activas. Si fuera necesario, también puedes verificar que en el entorno global no estén instaladas.

Conclusión

Y listo, ya tienes tu entorno virtual funcionando con todas las dependencias del proyecto, clonado desde GitHub.

Así que estos son los pasos que debes seguir para trabajar correctamente con proyectos en Python, un entorno virtual y un repositorio desde GitHub.