Freedom251 › Python Package Managers
Twine

What Twine is
Twine is a free tool for publishing Python packages to PyPI, TestPyPI, and other configured repositories, including private registries. It uploads source and binary distribution files that have already been built, without requiring it to run setup.py during upload. Twine accepts packaging formats including wheels, and its check command checks whether a distribution’s long description will render correctly on PyPI. It authenticates to PyPI over HTTPS using a verified connection, and can sign files with GPG or upload files signed beforehand. Repository settings can come from a .pypirc file, command-line options, or environment variables, which can be useful on CI or build servers. Twine can store repository credentials with keyring; headless Linux systems may need extra setup to store secrets securely. It supports macOS, Windows, and POSIX/Linux, requires Python 3.10 or later, and is licensed under Apache-2.0. It does not provide lockfile support, environment management, or dependency groups.
Who it suits
Twine suits developers who need to upload already-built Python package distributions to public or private repositories. It can also fit CI or build-server workflows that use environment-variable configuration.
What it does well
- Uploads source and binary distributions
- Supports wheels and other packaging formats
- Authenticates to PyPI over verified HTTPS
- Can sign files with GPG
What to know first
- Requires Python 3.10 or later
- Headless Linux may need extra keyring setup
- No lockfile support or environment management
- No dependency groups
Limits
Twine's free plan has no listed usage quota. Its keyring credential storage may need extra setup on headless Linux systems; the package also requires Python 3.10 or later.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Twine | Apache-2.0 · Python >=3.10 | Free |
As twine.readthedocs.io lists them, read 8 Oct 2026. The maker's own page has the final word.
Getting started
- Visit the Twine documentation website.
- Use a system running Linux, macOS, or Windows with Python 3.10 or later.
- Build the source or binary distribution files you want to publish.
- Set repository details with a `.pypirc` file, command-line options, or environment variables.
- Upload the built files to PyPI, TestPyPI, or another configured repository.
Verdict
Twine focuses on package publishing rather than building or managing environments. Its ability to upload pre-built files and configure repositories through environment variables may suit release and CI workflows.
Questions
How much does Twine cost?
Twine is free. Its plan is listed as free.
Which repositories can Twine publish to?
It can upload to PyPI, TestPyPI, and other configured repositories, including private registries.
Which operating systems does Twine support?
The listed platforms are Linux, macOS, and Windows.
Does Twine build packages during upload?
No. It uploads distribution files that have already been built and does not need to run setup.py during upload.
What license does Twine use?
Twine is licensed under Apache-2.0.
What Python version does Twine require?
It requires Python 3.10 or later.
Facts from Twine's own pages
- Automation
- The documentation notes that environment-variable configuration can be useful on CI or build servers. · twine.readthedocs.io, 7 Oct 2026
- Build independence
- Twine uploads already-built distribution files without requiring it to run setup.py. · twine.readthedocs.io, 7 Oct 2026
- Build workflow
- Twine uploads files that have already been created, so distributions can be tested before release without executing setup.py during upload. · twine.readthedocs.io, 8 Oct 2026
- Configuration
- Repository settings can be supplied through a .pypirc file, command-line options, or environment variables. · twine.readthedocs.io, 8 Oct 2026
- Credential storage
- Twine supports storing repository usernames and passwords securely using keyring. · twine.readthedocs.io, 8 Oct 2026
- Distribution checks
- The twine check command checks whether a distribution’s long description will render correctly on PyPI. · twine.readthedocs.io, 7 Oct 2026
- File signing
- Twine supports signing uploads with GPG and can upload pre-signed .asc files. · twine.readthedocs.io, 8 Oct 2026
- Intended users
- PyPI classifies Twine’s intended audience as developers. · pypi.org, 8 Oct 2026
- Keyring limitation
- The documentation says keyring may require additional setup on some systems, especially Linux headless environments. · twine.readthedocs.io, 8 Oct 2026
- License
- The package is licensed under Apache-2.0. · pypi.org, 8 Oct 2026
- Package checks
- The twine check command checks whether a distribution’s long description will render correctly on PyPI. · twine.readthedocs.io, 8 Oct 2026
- Package formats
- Twine supports any packaging format, including wheels. · twine.readthedocs.io, 7 Oct 2026
- Package uploads
- It uploads source and binary distribution files independently of the build system. · twine.readthedocs.io, 8 Oct 2026
- Purpose
- Twine is a utility for publishing Python packages to PyPI and other repositories. · twine.readthedocs.io, 8 Oct 2026
- Repositories
- Twine documentation shows uploading to PyPI, Test PyPI, and other package indexes configured by repository name or URL. · twine.readthedocs.io, 8 Oct 2026
- Runtime requirement
- The package requires Python 3.10 or later. · pypi.org, 8 Oct 2026
- Secure connection
- Twine authenticates to PyPI over HTTPS using a verified connection. · twine.readthedocs.io, 8 Oct 2026
- Security
- The documentation says Twine authenticates to PyPI over HTTPS using a verified connection. · twine.readthedocs.io, 7 Oct 2026
- Signing
- Twine supports signing files with GPG and uploading files that were signed in advance. · twine.readthedocs.io, 7 Oct 2026
- Supported formats
- Twine supports uploading any packaging format, including wheels. · twine.readthedocs.io, 8 Oct 2026
- Supported operating systems
- The PyPI project page lists macOS, Windows, and POSIX/Linux among its operating-system classifiers. · pypi.org, 7 Oct 2026
Where Twine stands on Freedom251
- Python Package Managers#23 of 27