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 pexYou can also build pex in a git clone using uv:
$ uv run dev-cmd package
$ cp dist/pex ~/binThis 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.pexEphemeral Environments
Run webserver.py in an environment containing flask as a quick way to experiment:
$ pex flask -- webserver.pyLaunch Sphinx in an ephemeral pex environment using the Sphinx entry point sphinx:main:
$ pex sphinx -e sphinx:main -- --helpUsing 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.pexSpecifying 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.pexMost 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-cmdThe 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 formatThat’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 typecheckAll of our tests allow passthrough arguments to pytest, which can be helpful to run specific tests:
$ uvrc test-py37-integration -- -k test_reproducible_buildTo run Pex from source, rather than through what is on your PATH, invoke via Python:
$ python -m pex3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pex-2.101.1.tar.gz.
File metadata
- Download URL: pex-2.101.1.tar.gz
- Upload date:
- Size: 5.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2b50d468244c2f9bd47b80507630cfdd6d910b39fce5ec32b6368da18ba88c94
|
|
| MD5 |
f8e5667fab8064c4726350e4badfaa2d
|
|
| BLAKE2b-256 |
85ded99f5985d55008d218712edcfa142434bb6566f36c699d63315f7fd7a272
|
Provenance
The following attestation bundles were made for pex-2.101.1.tar.gz:
Publisher:
release.yml on pex-tool/pex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pex-2.101.1.tar.gz -
Subject digest:
2b50d468244c2f9bd47b80507630cfdd6d910b39fce5ec32b6368da18ba88c94 - Sigstore transparency entry: 2621532052
- Sigstore integration time:
-
Permalink:
pex-tool/pex@25119186a189b4b5d2e519c8baf18845e826c18c -
Branch / Tag:
refs/tags/v2.101.1 - Owner: https://github.com/pex-tool
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@25119186a189b4b5d2e519c8baf18845e826c18c -
Trigger Event:
push
-
Statement type:
File details
Details for the file pex-2.101.1-py3.py312-none-any.whl.
File metadata
- Download URL: pex-2.101.1-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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51e91aa1bcc8ac311ba6e42822f5d6337d4affc553e0e2475c35976518ff3059
|
|
| MD5 |
31de085d33a6f4609f139697a9aa65fc
|
|
| BLAKE2b-256 |
ab3c0f25f6119175e60974437e1f47710878451f2f7634805a054580aa481890
|
Provenance
The following attestation bundles were made for pex-2.101.1-py3.py312-none-any.whl:
Publisher:
release.yml on pex-tool/pex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pex-2.101.1-py3.py312-none-any.whl -
Subject digest:
51e91aa1bcc8ac311ba6e42822f5d6337d4affc553e0e2475c35976518ff3059 - Sigstore transparency entry: 2621532062
- Sigstore integration time:
-
Permalink:
pex-tool/pex@25119186a189b4b5d2e519c8baf18845e826c18c -
Branch / Tag:
refs/tags/v2.101.1 - Owner: https://github.com/pex-tool
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@25119186a189b4b5d2e519c8baf18845e826c18c -
Trigger Event:
push
-
Statement type:
File details
Details for the file pex-2.101.1-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl.
File metadata
- Download URL: pex-2.101.1-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl
- Upload date:
- Size: 4.1 MB
- Tags: Python 2, Python 3.10, Python 3.11, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33f5f0bbf40ae92700a0a8d3da34d44ffea46a5cb6029f7b67746d9eba494927
|
|
| MD5 |
3f9e8b7198d25ceb105cb9f2907a7f8e
|
|
| BLAKE2b-256 |
18f590d32576edaa9b57a2b6dba186975deb5f0796d0be132a15d0d83c6fe817
|
Provenance
The following attestation bundles were made for pex-2.101.1-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl:
Publisher:
release.yml on pex-tool/pex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pex-2.101.1-py2.py35.py36.py37.py38.py39.py310.py311-none-any.whl -
Subject digest:
33f5f0bbf40ae92700a0a8d3da34d44ffea46a5cb6029f7b67746d9eba494927 - Sigstore transparency entry: 2621532069
- Sigstore integration time:
-
Permalink:
pex-tool/pex@25119186a189b4b5d2e519c8baf18845e826c18c -
Branch / Tag:
refs/tags/v2.101.1 - Owner: https://github.com/pex-tool
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@25119186a189b4b5d2e519c8baf18845e826c18c -
Trigger Event:
push
-
Statement type:
