Install & Compatibility
Where this runs
tested against v? · 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
py 3.10
✕ build_error
✓ 1.53s
py 3.11
✕ build_error
✕ build_error
py 3.12
✕ build_error
✕ build_error
py 3.13
✕ build_error
✕ build_error
py 3.9
✕ build_error
✓ 1.78s
142MB installed
● package 142MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
pyston_lite_autoload
✓ import pyston_lite_autoload
This import enables the Pyston JIT for the current Python process. There are typically no other modules or classes to import directly from Pyston for its JIT functionality itself. The 'pyston' package itself on PyPI is generally a placeholder, with the JIT functionality provided via 'pyston_lite_autoload'.
This quickstart demonstrates how to enable the Pyston JIT by simply importing `pyston_lite_autoload`. Once imported, the JIT automatically optimizes suitable Python code during execution, potentially leading to performance improvements without requiring any further code changes. For optimal observation, run a computationally intensive function.
import pyston_lite_autoload
import time
def fibonacci(n):
if n <= 1:
return n
else:
return fibonacci(n-1) + fibonacci(n-2)
if __name__ == "__main__":
print("Pyston JIT enabled by 'pyston_lite_autoload' import.")
n_val = 35 # A value that takes noticeable time to compute
start_time = time.perf_counter()
result = fibonacci(n_val)
end_time = time.perf_counter()
print(f"Fibonacci({n_val}) = {result}")
print(f"Time taken: {end_time - start_time:.4f} seconds")
# For benchmarking, run this script with and without the 'import pyston_lite_autoload'
# to observe potential performance differences.
Debug
Known issues
breakingUbuntu 16.04 support was removed in Pyston 2.3.2 due to a dependency dropping support. Users relying on the full Pyston distribution on this OS version must upgrade their operating system or use an older Pyston release.fixUpgrade to Ubuntu 18.04 or newer for the full Pyston distribution, or use an older Pyston version compatible with 16.04.
affects: >=2.3.2
gotchaThe primary way to enable the Pyston JIT for an existing Python environment via pip is to install `pyston_lite_autoload`. Attempting to install the `pyston` package via `pip` does not enable the JIT; `pyston` typically refers to the standalone Python distribution, installed via other means (e.g., .deb packages, portable archives).fixUse `pip install pyston_lite_autoload` to enable the JIT within a standard CPython environment. Avoid `pip install pyston` if you intend to use the JIT as an extension.
affects: All versions supporting `pyston_lite_autoload`
gotchaOlder portable releases of Pyston (e.g., v2.3_portable-v2) contained important bugs (e.g., related to issues #41 and #76) that were fixed in subsequent portable updates (e.g., v2.3_portable-v3). Users of portable distributions should ensure they have the latest patch version for stability.fixFor Pyston 2.3 portable users, ensure you are using `pyston_2.3_portable-v3.tar.gz` or newer, or switch to `pyston_lite_autoload` for easier updates.
affects: 2.3 (portable distribution only)
gotchaPyston versions prior to 2.3.2 might experience `setuptools` incompatibilities during package building or installation. A workaround was introduced in version 2.3.2.fixUpdate to Pyston 2.3.2 or newer. If using older versions, consult Pyston documentation for known `setuptools` workarounds or ensure `setuptools` is up-to-date and compatible.
affects: <2.3.2
gotchaPyston-full (the complete distribution) is API-compatible but not ABI-compatible with CPython. This means C extensions generally need to be recompiled when installing packages, which can sometimes lead to issues if binary wheels are not available for Pyston or if necessary build tools (like Rust compiler) are missing.fixWhen using Pyston-full, be prepared to recompile C extensions. Consider using `pyston_lite_autoload` with your existing CPython if recompilation is problematic for specific libraries.
affects: All versions of full Pyston distribution
Upgrade
Version history
2.3.5latest on PyPI · released Sep 26, 2022
Audit
Dependencies
No dependency data recorded yet.