https://github.com/pex-tool/pex/actions/workflows/ci.yml/badge.svg?branch=main https://img.shields.io/pypi/l/pex.svg https://img.shields.io/pypi/v/pex.svg https://img.shields.io/pypi/pyversions/pex.svg https://img.shields.io/pypi/wheel/pex.svg https://img.shields.io/discord/1205942638763573358

Overview

pex is a library for generating .pex (Python EXecutable) files which are executable Python environments in the spirit of virtualenvs. pex is an expansion upon the ideas outlined in PEP 441 and makes the deployment of Python applications as simple as cp. pex files may even include multiple platform-specific Python distributions, meaning that a single pex file can be portable across Linux and OS X.

pex files can be built using the pex tool. Build systems such as Pants, Buck, and {py}gradle also support building .pex files directly.

Still unsure about what pex does or how it works? Watch this quick lightning talk: WTF is PEX?.

pex is licensed under the Apache2 license.

Installation

To install pex, simply

$ pip install pex

You can also build pex in a git clone using uv:

$ uv run dev-cmd package
$ cp dist/pex ~/bin

This builds a pex binary in dist/pex that can be copied onto your $PATH. The advantage to this approach is that it keeps your Python environment as empty as possible and is more in-line with what pex does philosophically.

Simple Examples

Launch an interpreter with requests, flask and psutil in the environment:

$ pex requests flask 'psutil>2,<3'

Save Dependencies From Pip

Or instead freeze your current virtualenv via requirements.txt and execute it anywhere:

$ pex $(pip freeze) -o my_virtualenv.pex
$ deactivate
$ ./my_virtualenv.pex

Ephemeral Environments

Run webserver.py in an environment containing flask as a quick way to experiment:

$ pex flask -- webserver.py

Launch Sphinx in an ephemeral pex environment using the Sphinx entry point sphinx:main:

$ pex sphinx -e sphinx:main -- --help

Using Entry Points

Projects specifying a console_scripts entry point in their configuration can build standalone executables for those entry points.

To build a standalone pex-tools-executable.pex binary that runs the pex-tools console script found in all pex version 2.1.35 and newer distributions:

$ pex "pex>=2.1.35" --console-script pex-tools --output-file pex-tools-executable.pex

Specifying A Specific Interpreter

You can also build pex files that use a specific interpreter type:

$ pex "pex>=2.1.35" -c pex-tools --python=pypy -o pex-tools-pypy-executable.pex

Most pex options compose well with one another, so the above commands can be mixed and matched, and equivalent short options are available.

For a full list of options, just type pex --help.

Documentation

More documentation about Pex, building .pex files, and how .pex files work is available at https://docs.pex-tool.org.

Development

Pex uses uv with dev-cmd for test and development automation. After you have installed uv, to run the Pex test suite, just run dev-cmd via uv:

$ uv run dev-cmd

The dev-cmd command runner provides many useful options, explained at https://pypi.org/project/dev-cmd/ . Below, we provide some of the most commonly used commands when working on Pex, but the docs are worth acquainting yourself with to better understand how dev-cmd works and how to execute more advanced work flows.

To run a specific command, identify the name of the command you’d like to invoke by running uv run dev-cmd --list, then invoke the command by name like this:

$ uv run dev-cmd format

That’s a fair bit of typing. An shell alias is recommended, and the standard is uvrc which I’ll use from here on out.

To run MyPy:

$ uvrc typecheck

All of our tests allow passthrough arguments to pytest, which can be helpful to run specific tests:

$ uvrc test-py37-integration -- -k test_reproducible_build

To run Pex from source, rather than through what is on your PATH, invoke via Python:

$ python -m pex

Project links

Data verified by PyPI on Aug 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for benjyw from gravatar.com benjyw Avatar for John.Sirois from gravatar.com John.Sirois Avatar for wickman from gravatar.com wickman

Credits

Author: The PEX developers

GitHub Statistics

Data verified by PyPI on Aug 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <3.16, >=2.7

Provides Extra

subprocess management

Tags

package executable virtualenv lock freeze

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pex-2.100.5.tar.gz (5.4 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pex-2.100.5-py3.py312-none-any.whl (1.9 MB view details)

Uploaded Python 3Python 3.12

pex-2.100.5-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl (4.1 MB view details)

Uploaded Python 2Python 3.10Python 3.11Python 3.5Python 3.6Python 3.7Python 3.8Python 3.9

File details

Details for the file pex-2.100.5.tar.gz.

File metadata

  • Download URL: pex-2.100.5.tar.gz
  • Upload date:
  • Size: 5.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pex-2.100.5.tar.gz
Algorithm Hash digest
SHA256 81a2363f02ffd0f153912529793c8c49746c0a06b46f82d8be6aa3350bf33b35
MD5 32c3c4c6b7c83f4c4cdcc5cd7892b5bb
BLAKE2b-256 d65b467797ecb3d8ec8e603a1a592aece0e0ccdb7669601b8424775aa4055787

See more details on using hashes here.

Provenance

The following attestation bundles were made for pex-2.100.5.tar.gz:

Publisher: release.yml on pex-tool/pex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pex-2.100.5-py3.py312-none-any.whl.

File metadata

  • Download URL: pex-2.100.5-py3.py312-none-any.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: Python 3, Python 3.12
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pex-2.100.5-py3.py312-none-any.whl
Algorithm Hash digest
SHA256 dcb4c7ca502cd5a4149f7ecef0e51dc006bce6b4a91d195c766cedf9476bd5b3
MD5 d4cef7980e1392621ecc9f4ec7205820
BLAKE2b-256 697c4f07a9bf507c3467d55e124b25c29e3cee0b062ba11cd95e0cf31e5eba24

See more details on using hashes here.

Provenance

The following attestation bundles were made for pex-2.100.5-py3.py312-none-any.whl:

Publisher: release.yml on pex-tool/pex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pex-2.100.5-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl.

File metadata

File hashes

Hashes for pex-2.100.5-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl
Algorithm Hash digest
SHA256 991b280678cefc0d655585e19175555b23c27331cf8c626a89273c3f5f86b0d2
MD5 fbd826139f563eae4ac244682139c2d9
BLAKE2b-256 62996ba8d34413e6aad0bf9a14257b6c9dcfe811057fdbb1cf08e76edf4793c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for pex-2.100.5-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl:

Publisher: release.yml on pex-tool/pex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.100.5

2.100.4

2.100.3

2.100.2

2.100.1

2.100.0

2.99.0

2.98.5

2.98.4

2.98.3

2.98.2

2.98.1

2.98.0

2.97.3

2.97.2

2.97.1

2.97.0

2.96.2

2.96.1

2.96.0

2.95.3

2.95.2

2.95.1

2.95.0

2.94.0

2.93.4

2.93.3

2.93.2

2.93.1

2.93.0

2.92.3

2.92.2

2.92.1

2.92.0

2.91.8

2.91.7

2.91.6

2.91.5

2.91.4

2.91.3

2.91.2

2.91.1

2.91.0

2.90.3

2.90.2

2.90.1

2.90.0

2.89.1

2.89.0

2.88.1

2.88.0

2.87.0

2.86.1

2.86.0

2.85.3

2.85.2

2.85.1

2.85.0

2.84.0

2.83.0

2.82.1

2.82.0

2.81.0

2.80.0

2.79.0

2.78.0

2.77.3

2.77.2

2.77.1

2.77.0

2.76.1

2.76.0

2.75.2

2.75.1

2.75.0

2.74.3

2.74.2

2.74.1

2.74.0

2.73.1

2.73.0

2.72.2

2.72.1

2.72.0

2.71.1

2.71.0

2.70.0

2.69.2

2.69.1

2.69.0

2.68.3

2.68.2

2.68.1

2.68.0

2.67.3

2.67.2

2.67.1

2.67.0

2.66.1

2.66.0

2.65.0

2.64.1

2.64.0

2.63.0

2.62.1

2.62.0

2.61.1

2.61.0

2.60.2

2.60.1

2.60.0

2.59.5

2.59.4

2.59.3

2.59.2

2.59.1

2.59.0

2.58.1

2.58.0

2.57.0

2.56.0

2.55.2

2.55.1

2.55.0

2.54.2

2.54.1

2.54.0

2.53.0

2.52.1

2.52.0

2.51.1

2.51.0

2.50.4

2.50.3

2.50.2

2.50.1

2.50.0

2.49.0

2.48.2

2.48.1

2.48.0

2.47.0

2.46.3

2.46.2

2.46.1

2.46.0

2.45.3

2.45.2

2.45.1

2.45.0

2.44.0

2.43.1

2.43.0

2.42.2

2.42.1

2.42.0

2.41.1

2.41.0

2.40.3

2.40.2

2.40.1

2.40.0

2.39.0

2.38.1

2.38.0

2.37.0

2.36.1

2.36.0

2.35.0

2.34.0

2.33.10

2.33.9

2.33.8

2.33.7

2.33.6

2.33.5

2.33.4

2.33.3

2.33.2

2.33.1

2.33.0

2.32.1

2.32.0

2.31.0

2.30.0

2.29.0

2.28.1

2.28.0

2.27.1

2.27.0

2.26.0

2.25.2

2.25.1

2.25.0

2.24.3

2.24.2

2.24.1

2.24.0

2.23.0

2.22.0

2.21.0

2.20.4

2.20.3

2.20.2

2.20.1

2.20.0

2.19.1

2.19.0

2.18.1

2.18.0

2.17.0

2.16.2

2.16.1

2.16.0

2.15.0

2.14.1

2.14.0

2.13.1

2.13.0

2.12.1

2.12.0

2.11.0

2.10.1

2.10.0

2.9.0

2.8.1

2.8.0

2.7.0

2.6.3

2.6.2 yanked

Reason this release was yanked:

Neither the pex.pdf nor the Pex PEX were released at https://github.com/pex-tool/pex/releases. Please use 2.6.3 which is a re-release of the same code.

2.6.1 yanked

Reason this release was yanked:

Neither the pex.pdf nor the Pex PEX were released at https://github.com/pex-tool/pex/releases. Please us 2.6.2 which is a re-release of the same code.

2.6.0

2.5.0

2.4.1

2.4.0

2.3.3

2.3.2

2.3.1

2.3.0

2.2.2

2.2.1

2.2.0

2.1.164

2.1.163

2.1.162

2.1.161

2.1.160

2.1.159

2.1.158

2.1.157

2.1.156

2.1.155

2.1.154

2.1.153

2.1.152

2.1.151

2.1.150

2.1.149

2.1.148

2.1.147

2.1.146

2.1.145

2.1.144

2.1.143

2.1.142

2.1.141

2.1.140

2.1.139

2.1.138

2.1.137

2.1.136

2.1.135

2.1.134

2.1.133

2.1.132

2.1.131

2.1.130

2.1.129

2.1.128

2.1.127

2.1.126

2.1.125

2.1.124

2.1.123

2.1.122

2.1.121

2.1.120

2.1.119

2.1.118

2.1.117

2.1.116

2.1.115

2.1.114

2.1.113

2.1.112

2.1.111

2.1.110

2.1.109

2.1.108

2.1.107

2.1.106

2.1.105

2.1.104

2.1.103

2.1.102

2.1.101

2.1.100

2.1.99

2.1.98

2.1.97

2.1.96

2.1.95

2.1.94

2.1.93

2.1.92

2.1.91

2.1.90

2.1.89

2.1.88

2.1.87

2.1.86

2.1.85

2.1.84

2.1.83

2.1.82

2.1.81

2.1.80

2.1.79

2.1.78

2.1.77

2.1.76

2.1.75

2.1.74

2.1.73

2.1.72

2.1.71

2.1.70

2.1.69

2.1.68

2.1.67

2.1.66

2.1.65

2.1.64

2.1.63

2.1.62

2.1.61

2.1.60

2.1.59

2.1.58

2.1.57

2.1.56

2.1.55

2.1.54

2.1.53

2.1.52

2.1.51

2.1.50

2.1.49

2.1.48

2.1.47

2.1.46

2.1.45

2.1.44

2.1.43

2.1.42

2.1.41

2.1.40

2.1.39

2.1.38

2.1.37

2.1.36

2.1.35

2.1.34

2.1.33

2.1.32

2.1.31

2.1.30

2.1.29

2.1.28

2.1.27

2.1.26

2.1.25

2.1.24

2.1.23

2.1.22

2.1.21

2.1.20

2.1.19

2.1.18

2.1.17

2.1.16

2.1.15

2.1.14

2.1.13

2.1.12

2.1.11

2.1.10

2.1.9

2.1.8

2.1.7

2.1.6

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.1.0

2.0.3

2.0.2

2.0.1

2.0.0

1.6.12

1.6.11

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.3

1.5.2

1.5.1

1.5.0

1.4.9

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.2

1.3.1

1.3.0

1.2.16

1.2.15

1.2.14

1.2.13

1.2.12

1.2.11

1.2.10

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.20

1.1.19

1.1.18

1.1.17

1.1.16

1.1.15

1.1.14

1.1.13

1.1.12

1.1.11

1.1.10

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.3

1.0.2

1.0.1

1.0.0

1.0.0.dev3 pre-release

1.0.0.dev0 pre-release

0.9.0

0.8.6

0.8.5

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.0

0.1.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page