9/6/23, 21:09 Installing packages using pip and virtual environments — Python Packaging User Guide

Go

Installing packages using pip and virtual environments

This guide discusses how to install packages using pip and a virtual environment manager: either venv for Pyt-
hon 3 or virtualenv for Python 2. These are the lowest-level tools for managing Python packages and are re-
commended if higher-level tools do not suit your needs.

Note: Este documento usa el término paquete para referirse a un paquete de distribución que es dife-
rente de un paquete de importación que se usa para importar módulos en su código fuente de Python.

Instalando pip
pip es el administrador de paquetes de Python de referencia. Se utiliza para instalar y actualizar paquetes.
Deberá asegurarse de tener instalada la última versión de pip.

Unix/mac OS ventanas

Los instaladores de Python para Windows incluyen pip. Puede asegurarse de que pip esté actualizado
ejecutando:

py -m pip install --upgrade pip

py -m pip --version

Luego, deberías tener la última versión de pip:

pip 21.1.3 from c:\python39\lib\site-packages (Python 3.9.4)

Instalando entorno virtual

Nota: Si está utilizando Python 3.3 o posterior, el venv módulo es la forma preferida de crear y administrar
entornos virtuales. venv está incluido en la biblioteca estándar de Python y no requiere instalación adicio-
nal. Si está utilizando venv, puede omitir esta sección.

virtualenv se usa para administrar paquetes de Python para diferentes proyectos. El uso de virtualenv le per-
mite evitar la instalación de paquetes de Python globalmente, lo que podría dañar las herramientas del sis-
tema u otros proyectos. Puede instalar virtualenv usando pip.

Unix/mac OS ventanas

py -m pip install --user virtualenv

Creando un entorno virtual

venv (para Python 3) y virtualenv (para Python 2) le permiten administrar instalaciones de paquetes separa-
dos para diferentes proyectos. Básicamente, le permiten crear una instalación de Python aislada "virtual" e
instalar paquetes en esa instalación virtual. Cuando cambia de proyecto, simplemente puede crear un nuevo
entorno virtual y no tener que preocuparse por romper los paquetes instalados en los otros entornos. Siempre
se recomienda utilizar un entorno virtual al desarrollar aplicaciones de Python.  v: último 

https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/ 1/5
9/6/23, 21:09 Installing packages using pip and virtual environments — Python Packaging User Guide

Para crear un entorno virtual, vaya al directorio de su proyecto y ejecute venv. Si está utilizando Python 2, re-
emplácelo venv con virtualenv los siguientes comandos.

Unix/mac OS ventanas

py -m venv env

El segundo argumento es la ubicación para crear el entorno virtual. En general, puede simplemente crear esto
en su proyecto y llamarlo env .

venv creará una instalación virtual de Python en la env carpeta.

Nota: Debe excluir su directorio de entorno virtual de su sistema de control de versiones utilizando
.gitignore o similar.

Activando un entorno virtual

Antes de que pueda comenzar a instalar o usar paquetes en su entorno virtual, deberá activarlo . La activa-
ción de un entorno virtual colocará los archivos ejecutables python y específicos del entorno virtual pip en el
archivo PATH .

Unix/mac OS ventanas

.\env\Scripts\activate

Puede confirmar que está en el entorno virtual comprobando la ubicación de su intérprete de Python:

Unix/mac OS ventanas

where python

Debe estar en el env directorio:

Unix/mac OS ventanas

...\env\Scripts\python.exe

Siempre que su entorno virtual esté activado, pip instalará paquetes en ese entorno específico y podrá impor-
tar y usar paquetes en su aplicación Python.

Saliendo del entorno virtual

Si desea cambiar de proyecto o abandonar su entorno virtual, simplemente ejecute:

deactivate

Si desea volver a ingresar al entorno virtual, simplemente siga las mismas instrucciones anteriores sobre
cómo activar un entorno virtual. No es necesario volver a crear el entorno virtual.

Instalando paquetes
 v: último
Ahora que está en su entorno virtual, puede instalar paquetes. Instalemos la biblioteca de solicitudes del ín-
dice de paquetes de Python (PyPI) :

https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/ 2/5
9/6/23, 21:09 Installing packages using pip and virtual environments — Python Packaging User Guide

Unix/mac OS ventanas

py -m pip install requests

pip debe descargar las solicitudes y todas sus dependencias e instalarlas:

Collecting requests
Using cached requests-2.18.4-py2.py3-none-any.whl
Collecting chardet<3.1.0,>=3.0.2 (from requests)
Using cached chardet-3.0.4-py2.py3-none-any.whl
Collecting urllib3<1.23,>=1.21.1 (from requests)
Using cached urllib3-1.22-py2.py3-none-any.whl
Collecting certifi>=2017.4.17 (from requests)
Using cached certifi-2017.7.27.1-py2.py3-none-any.whl
Collecting idna<2.7,>=2.5 (from requests)
Using cached idna-2.6-py2.py3-none-any.whl
Installing collected packages: chardet, urllib3, certifi, idna, requests
Successfully installed certifi-2017.7.27.1 chardet-3.0.4 idna-2.6 requests-2.18.4 urllib3-1

Instalación de versiones específicas

pip le permite especificar qué versión de un paquete instalar utilizando especificadores de versión . Por ejem-
plo, para instalar una versión específica de requests :

Unix/mac OS ventanas

py -m pip install "requests==2.18.4"

Para instalar la última 2.x versión de solicitudes:

Unix/mac OS ventanas

py -m pip install "requests>=2.0.0,<3.0.0"

Para instalar versiones preliminares de paquetes, use la --pre marca:

Unix/mac OS ventanas

py -m pip install --pre requests

Instalación de extras
Algunos paquetes tienen extras opcionales . Puede decirle a pip que los instale especificando el extra entre
paréntesis:

Unix/mac OS ventanas

py -m pip install "requests[security]"

Instalando desde la fuente

pip puede instalar un paquete directamente desde la fuente, por ejemplo:
 v: último 
Unix/mac OS ventanas

https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/ 3/5
9/6/23, 21:09 Installing packages using pip and virtual environments — Python Packaging User Guide

cd google-auth
py -m pip install .

Additionally, pip can install packages from source in development mode, meaning that changes to the source
directory will immediately affect the installed package without needing to re-install:

Unix/macOS Windows

py -m pip install --editable .

Installing from version control systems

pip can install packages directly from their version control system. For example, you can install directly from a
git repository:

google-auth @ git+https://github.com/GoogleCloudPlatform/google-auth-library-python.git

For more information on supported version control systems and syntax, see pip’s documentation on VCS
Support.

Installing from local archives

If you have a local copy of a Distribution Package’s archive (a zip, wheel, or tar file) you can install it directly
with pip:

Unix/macOS Windows

py -m pip install requests-2.18.4.tar.gz

If you have a directory containing archives of multiple packages, you can tell pip to look for packages there
and not to use the Python Package Index (PyPI) at all:

Unix/macOS Windows

py -m pip install --no-index --find-links=/local/dir/ requests

This is useful if you are installing packages on a system with limited connectivity or if you want to strictly con-
trol the origin of distribution packages.

Using other package indexes

If you want to download packages from a different index than the Python Package Index (PyPI), you can use
the --index-url flag:

Unix/macOS Windows

py -m pip install --index-url http://index.example.com/simple/ SomeProject

If you want to allow packages from both the Python Package Index (PyPI) and a separate index, you can use
the --extra-index-url flag instead:

Unix/macOS Windows  v: último 

py -m pip install --extra-index-url http://index.example.com/simple/ SomeProject

https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/ 4/5
9/6/23, 21:09 Installing packages using pip and virtual environments — Python Packaging User Guide

Upgrading packages
pip can upgrade packages in-place using the --upgrade flag. For example, to install the latest version of
requests and all of its dependencies:

Unix/macOS Windows

py -m pip install --upgrade requests

Using requirements files

Instead of installing packages individually, pip allows you to declare all dependencies in a Requirements File.
For example you could create a requirements.txt file containing:

requests==2.18.4
google-auth==1.1.0

And tell pip to install all of the packages in this file using the -r flag:

Unix/macOS Windows

py -m pip install -r requirements.txt

Freezing dependencies
Pip can export a list of all installed packages and their versions using the freeze command:

Unix/macOS Windows

py -m pip freeze

Which will output a list of package specifiers such as:

cachetools==2.0.1
certifi==2017.7.27.1
chardet==3.0.4
google-auth==1.1.1
idna==2.6
pyasn1==0.3.6
pyasn1-modules==0.1.4
requests==2.18.4
rsa==3.4.2
six==1.11.0
urllib3==1.22

Esto es útil para crear archivos de requisitos que pueden volver a crear las versiones exactas de todos los pa-
quetes instalados en un entorno.

 v: último 

https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/ 5/5