To run Pants, you need:
- Linux (x86_64) or macOS.
- Python 3.7+ discoverable on your
- Internet access (so that Pants can fully bootstrap itself).
Some Linux distributions may need additional packages
On Ubuntu you may need to run:
apt install -y python3-dev python3-distutils.
Alpine Linux is not yet supported
Pants for Linux is currently distributed as a manylinux wheel. Alpine Linux is not covered by manylinux (it uses MUSL libc while manylinux requires glibc), so at present Pants will not run on Alpine Linux.
If you need to run Pants on Alpine, let us know, so we can prioritize this work.
Meanwhile, you can try building Pants yourself on Alpine.
Linux on ARM is not yet supported
Pants for Linux is currently only distributed as an x86_64 wheel.
If you need to run Pants on ARM, let us know, so we can prioritize this work.
Meanwhile you can try building Pants yourself on ARM.
Python 2 compatibility
Pants requires Python 3.7+ to run itself, but it can build Python 2 code (and earlier Python versions like 3.6).
Using a proxy?
See Proxies for instructions.
Pants is invoked via a launch script named
./pants , saved at the root of the repository. This script will install Pants and handle upgrades.
First, set up a minimal
pants.toml config file to instruct the script to download the latest 2.4 release:
printf '[GLOBAL]\npants_version = "2.4.1"\n' > pants.toml
Then, download the script:
curl -L -o ./pants https://pantsbuild.github.io/setup/pants && \ chmod +x ./pants
Now, run this to bootstrap Pants and to verify the version it installs:
./pantsto version control
This will allow all users in the project to use Pants without having to install it themselves.
We currently distribute Pants for Linux (x86_64) and MacOS.
If you need to run Pants on some other platform, such as Linux on ARM, or Alpine Linux, you can try building it yourself by checking out the Pants repo, and running
Updated 3 days ago