Registry / devops / pbs-installer

pbs-installer

JSON →
library2026.8.25pypypi✓ verified 25d ago

pbs-installer is a Python library that serves as an installer for @indygreg's python-build-standalone. It automates the process of downloading and installing specific Python versions in a standalone fashion. The library is actively maintained with frequent releases, often multiple times a month, and is currently at version 2026.3.25.

pip install pbs-installer
INSTALL
IMPORT
SIG · PBS-INSTALLER
P
pbs-installer
devopspythonv2026.8.25
Install
2.2s avg
Import
64ms
Disk
22MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v2026.8.25 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.910 runs
installs and imports cleanly · install 0.0s · import 0.067s · 24.3MB
glibc
py 3.103.910 runs
installs and imports cleanly · install 2.2s · import 0.061s · 25MB
22MB installed
● package 22MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

install
from pbs_installer import install
download
from pbs_installer import download
The `download` function is often used internally by `install`, but can be called directly.

This quickstart demonstrates how to use the `install` function from `pbs_installer` to download and install a specific version of CPython into a local directory. It highlights the main entry point for programmatic usage.

import os from pbs_installer import install # Define the target directory for Python installation install_path = os.path.join(os.getcwd(), "my_python_env") python_version = "3.10" # Example: install CPython 3.10 print(f"Attempting to install CPython {python_version} to {install_path}") try: # Ensure optional dependencies are installed for full functionality, e.g., via `pip install pbs-installer[all]` install(request=python_version, destination=install_path) print(f"CPython {python_version} installed successfully to {install_path}") except Exception as e: print(f"Error installing Python: {e}") # Example of how to verify installation (simplified) # This would typically involve checking for the python executable in install_path python_executable = os.path.join(install_path, 'bin', 'python') if os.name == 'posix' else os.path.join(install_path, 'python.exe') if os.path.exists(python_executable): print(f"Python executable found at: {python_executable}") else: print(f"Python executable NOT found at: {python_executable}")
pbs-installer --version
Debug
Known issues
gotchaFull functionality requires optional dependencies `httpx` and `zstandard`. Without them, downloading might fail (e.g., `ModuleNotFoundError` for `httpx`) or Zstandard-compressed builds cannot be extracted.
fix
Install `pbs-installer` with the `[all]` extra: `pip install pbs-installer[all]`.
affects: All versions
gotchaThere are multiple unrelated Python libraries or projects with 'PBS' in their name (e.g., `pbs-python` for Torque/OpenPBS, `pbs` for subprocess management). Ensure you are importing and using `pbs_installer` from `frostming` for Python Build Standalone installations.
fix
Verify your imports: `from pbs_installer import install` and confirm `pypi.org/project/pbs-installer` is the intended library.
affects: All versions
gotchaThe `request` parameter for the `install` function expects specific Python version strings (e.g., '3.10', '3.10.4', 'pypy-3.9'). Passing malformed or ambiguous strings might result in a `ValueError` if a matching build cannot be found.
fix
Consult the `pbs-installer` documentation or source code for supported version string formats. Use precise version numbers.
affects: All versions
gotchaWhen installing Python for a different target environment (cross-compiling) or if auto-detection fails, explicitly specifying the `arch` and `platform` parameters in the `install` function is crucial. Omitting them might lead to downloading an incompatible Python build for the current system.
fix
Pass `arch='x86_64'`, `platform='linux'` (or appropriate values) to the `install` function to ensure the correct standalone build is selected.
affects: All versions
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'pbs_installer'
The 'pbs-installer' package is not installed in the current Python environment or the environment is not properly activated.
fix
pip install pbs-installer
pbs-installer: command not found
The 'pbs-installer' command-line tool is not installed or its installation directory is not included in the system's PATH environment variable.
fix
Ensure the package is installed with `pip install pbs-installer`, then restart your terminal or verify that the Python environment's script directory is in your system's PATH.
OSError: [Errno 13] Permission denied: '/usr/local/python/3.10.8'
The user is attempting to install a standalone Python build into a system-protected directory where they lack write permissions.
fix
Specify an installation directory where the current user has write permissions using the `--path` argument (e.g., `pbs-installer install 3.10.8 --path ~/.pythons/3.10.8`), or run the command with elevated privileges (`sudo pbs-installer ...`) if installing to a system-wide location is absolutely necessary (though generally discouraged for standalone builds).
checksum mismatch for https://github.com/indygreg/python-build-standalone/releases/download/...
The downloaded Python build file is corrupted, incomplete, or its checksum no longer matches the expected value, possibly due to a network issue, an interrupted download, or an upstream change to the build artifact.
fix
Clear the local cache using `pbs-installer clear-cache` and then retry the installation. If the issue persists, verify your network connection or check the `python-build-standalone` GitHub releases for any reported issues with the specific build version.
No such Python build exists for version '3.10.99' for platform 'linux-x86_64'.
The specified Python version (e.g., '3.10.99') does not have a pre-built standalone package available for the current operating system and architecture on the `python-build-standalone` releases page.
fix
Check the official `python-build-standalone` GitHub releases or the output of `pbs-installer list` for a list of available and supported Python versions for your platform, and use one of those.
Upgrade
Version history
2026.8.25latest on PyPI · released Aug 25, 2026
Audit
Dependencies
httpxoptionalRequired for downloading Python build files from URLs. Part of the `[download]` extra.
zstandardoptionalRequired for extracting Python build files compressed with Zstandard. Part of the `[install]` extra.
pythonrequiredRequires Python 3.8 or newer to run the installer itself.
Agent activity
13 hits · last 30 days
node
12
Resources
pbs-installer — pip install pbs-installer · libregistry