Pants v2: The ergonomic build system

Welcome to the Pants v2 documentation hub!

Pants v2 is a fast, scalable, user-friendly build system for growing codebases. It's currently focused on Python, with support for other languages coming soon.

Here you'll find guides to help you get started with Pants v2, comprehensive documentation on how to configure, run and customize Pants v2, and information on how to get help from the Pants community.

Get Started


Options related to sending anonymous stats to the Pants project, to aid development.

Config section: [anonymous-telemetry]

Basic options


Advanced options


default: False

Whether to send anonymous telemetry to the Pants project. Telemetry is sent asynchronously, with silent failure, and does not impact build times or outcomes. See for details.


default: None

An anonymized ID representing this repo. For private repos, you likely want the ID to not be derived from, or algorithmically convertible to, anything identifying the repo. For public repos the ID may be visible in that repo's config file, so anonymity of the repo is not guaranteed (although user anonymity is always guaranteed). See for details.

Deprecated options


Updated about a month ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.