Table of contents

Ambiente Virtual de Python en Ubuntu

Ambiente Virtual de Python en Ubuntu

DESCRIPTION

Este documento explica cómo crear un entorno virtual Python (venv) en Ubuntu 24.04 para un usuario determinado. Por usuario significa que puedes instalar esto en tu directorio personal y usarlo en lugar de la instalación por defecto de Python para todo el sistema.

Para crear un entorno virtual en Python en Ubuntu 24.04, usas el módulo venv que Python provee via PIP. Esto aísla las dependencias por proyectos en la instalación específica del ambiente virtual de Python.

En esta lección:

instalar python3
Crear un entorno virtual de Python
Resolución de problemas al crear un entorno virtual de Python
eliminar un entorno virtual de python

DEPENDENCIES

ninguna

REQUIREMENTS

Sistema Ubuntu Linux.
Algunos comandos requieren privilegios elevados.

WARNING

ninguna.

Ambiente de trabajo

En esta leccion usamos el sistema operativo Ubuntu.

-> lsb_release -a
Distributor ID:	Ubuntu
Description:	Ubuntu 24.04.4 LTS
Release:	24.04
Codename:	noble

Instalación manual de Python

Python3 está disponible por defecto en Ubuntu 24.04.

Pero, si quieres instalar una versión manualmente, haz los comandos que aparecen a continuación.

-> sudo apt-get install software-properties-common
-> sudo add-apt-repository ppa:deadsnakes/ppa
-> sudo apt-get update
-> apt-get install python3 python3-dev

Crea Carpeta VENV

Abre el terminal.
Navega al directorio de tu proyecto usando el comando cd.

Si aún no tienes una carpeta de proyectos, crea una usando mkdir y luego cambia a esa carpteta con el comando cd.

Puedes crear tantos VENVs como quieras en la ubicación que prefieras. Elige el nombre de directorio que quieras. Por ejemplo, aqui he decidido crear la carpeta $HOME/python-venv.

-> mkdir $HOME/python-venv

-> ls -ld $HOME/python-venv
drwxrwxr-x 2 devuser devuser 4096 May  9 20:55 /home/devuser/python-venv/

Cambiemos a la nueva carpeta.

-> cd $HOME/python-venv

Crea El Ambiente Virtual

Ejecuta el siguiente comando para crear un entorno virtual. Es una práctica habitual llamar el entorno venv o .venv, pero puedes ponerle el nombre que quieras.

Sintaxis:

venv: es el módulo que Python utiliza para crear el entorno
virtual-env-name: es el nombre del entorno que elijas

python3 -m venv <virtual-env-name>

venv es un módulo nativo de Python
puedes nombrar a tu entorno virtual de Python como quieras.

Opcionalmente, podemos identificar la versión de python y usarla en el nombre del ambiente virtual para pode identificarlo fácilmente en caso que queramos crear ambientes para diferentes versiones de Python.

-> python3 --version
Python 3.12.3

-> python3 -m venv venv-3.12.3

-> ls -ld venv-3.12.3/
drwxrwxr-x 5 devuser devuser 4096 May  9 21:08 venv-3.12.3/

En este listado parcial usamos el comando tree para mostrar el contenido del directorio BIN del entorno que hemos creado.

-> tree venv-3.12.3/ | head -15
venv-3.12.3/
├── bin
│   ├── Activate.ps1
│   ├── activate
│   ├── activate.csh
│   ├── activate.fish
│   ├── pip
│   ├── pip3
│   ├── pip3.12
│   ├── python -> python3
│   ├── python3 -> /usr/bin/python3
│   └── python3.12 -> python3
├── include
│   └── python3.12
├── lib

Activa El Python Venv

Re-lee del archivo de esta manera para activar el ambiente:

# activate Python venv
-> source ~/python-venv/venv-3.12.3/bin/activate

Eso hace que ese entorno de python esté disponible y listo para usar.

El prompt cambiará para mostrar el nombre del entorno virtual en la primera línea.

(venv-3.12.3)
Sat 2026May09 21:13:33 UTC
devuser@client1
~/python-venv
hist:109 -> 

A partir de aquí, por defecto, usarás los binarios en este entorno virtual.

-> which python
/home/devuser/python-venv/venv-3.12.3/bin/python

-> python --version
Python 3.12.3


-> which pip
/home/devuser/python-venv/venv-3.12.3/bin/pip

-> pip --version
pip 24.0 from /home/devuser/python-venv/venv-3.12.3/lib/python3.12/site-packages/pip (python 3.12)

Puedes desactivar el entorno virtual de Python simplemente ejecutando:

-> deactivate

Establecer PyEnv en Ubuntu 24.04 (.bashrc / .zshrc)

Puedes añadir la línea de exportación en ~/.bashrc para habilitar el entorno cuando inicies sesión en un terminal.

export PATH=/home/devuser/python-venv/venv-3.12.3/bin:$PATH
source ~/python-venv/venv-3.12.3/bin/activate

Resolución de problemas Fallo para crear un entorno virtual de Python

Aquí hubo un problema y no se logró crear un entorno virtual de Python.

-> python3 -m venv venv1
The virtual environment was not created successfully because ensurepip is not
available.  On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.

    apt install python3.12-venv

You may need to use sudo with that command.  After installing the python3-venv
package, recreate your virtual environment.

Failing command: /home/devuser/python-venv/venv1/bin/python3

Comprobemos la versión instalada en Python.

-> python3 --version
Python 3.12.3

Como indica el mensaje, instala el paquete usando el número de versión indicado arriba

sudo apt install python3.12-venv

Aqui vemos la salida parcial del comando anterior para intalar el paquete:

...snip...
Unpacking python3.12-venv (3.12.3-1ubuntu0.13) ...
Setting up python3-setuptools-whl (68.1.2-2ubuntu1.2) ...
Setting up python3-pip-whl (24.0+dfsg-1ubuntu1.3) ...
Setting up python3.12-venv (3.12.3-1ubuntu0.13) .

python3-venv: es un paquete de Debian/Ubuntu que instala el módulo stdlib venv y cualquier archivo de soporte a nivel de sistema operativo necesario para crear entornos virtuales desde el sistema Python.

python3 -m venv: es el comando que realmente crea un entorno virtual usando el módulo ‘venv’ desde el intérprete python3 que invoques.

Uninstalar Un Python Venv

Para desinstalar un Venv en Python, simplemente elimina el directorio en el que lo creaste.

-> rm -rf ~/python-venv/venv-3.12.3

Además, elimina cualquier variable de exportación en ~/.bashrc si has añadido alguna.

Conclusion

Este proceso mostró cómo crear un entorno local de Python listo para su desarrollo completo. Podemos escribir y ejecutar código. Instala módulos adicionales de python para ampliar su funcionalidad. Podemos experimentar creando más de un entorno virtual y adaptarlo a un caso de uso específico.

Referencias

Glossary De Comandos

python3: El binario estándar de Python
pip: Utilidad para gestionar módulos de Python