Pyston Autoload

2.3.5 · active · verified Wed Apr 15

Pyston-Autoload automatically detects and enables the Pyston JIT compiler when imported, aiming to provide performance improvements for Python applications. It acts as a bootstrap mechanism for the Pyston runtime. The current version is 2.3.5, and it generally follows the release cadence of the underlying Pyston project.

Warnings

gotcha Pyston-Autoload only *enables* an existing Pyston runtime; it does not install Pyston itself. Pyston often requires platform-specific installation methods (e.g., .deb packages, portable archives, or conda environments) which need to be set up independently.
Fix: Ensure Pyston (or Pyston-Lite) is correctly installed for your system architecture and distribution *before* installing and importing `pyston-autoload`.
gotcha A distinction exists between `pyston-autoload` and `pyston_lite_autoload`. `pyston-autoload` is for the full Pyston distribution, while `pyston_lite_autoload` (introduced in v2.3.4) is for `pyston_lite`, which is distributed as a Python extension module via PyPI.
Fix: Choose the correct autoload package based on your Pyston installation strategy: `pyston-autoload` for full Pyston, `pyston_lite_autoload` if you're installing `pyston_lite` via `pip install pyston_lite_autoload`.
gotcha To ensure Pyston's JIT is active for the entire application, `import pyston_autoload` should be one of the very first statements in your main application script.
Fix: Place `import pyston_autoload` at the top of your primary Python script or module that runs your application.
breaking Support for Ubuntu 16.04 was removed due to dependencies removing support. This means portable releases are now based on Ubuntu 18.04.
Fix: Upgrade your operating system to Ubuntu 18.04 or newer, or use a portable Pyston release based on a supported OS version.
gotcha Pyston is distributed with architecture-specific packages (e.g., `amd64` for Intel/AMD x86_64, `arm64` for aarch64 ARM CPUs). Ensure the underlying Pyston runtime matches your system's architecture.
Fix: When installing the Pyston runtime, download the package corresponding to your CPU architecture (e.g., `amd64` or `arm64`). This is particularly important for the full Pyston distribution.

Install

pip install pyston-autoload Install for full Pyston
pip install pyston_lite_autoload Install for Pyston-Lite (extension module)

Imports

pyston_autoload
```
import pyston_autoload
```

Quickstart

This quickstart demonstrates the core usage of `pyston-autoload`: a simple import at the beginning of your script. This import will automatically enable the Pyston JIT if a compatible Pyston runtime is found in the environment. If Pyston is not detected, the import will succeed, but the JIT will not be active.

import pyston_autoload
import sys

print(f"Pyston Autoload imported. This enables the Pyston JIT if the Pyston runtime is detected.")
print(f"Current Python version: {sys.version}")

# Run some typical Python code. If Pyston is active, it may run faster.
def fib(n):
    if n <= 1:
        return n
    else:
        return fib(n-1) + fib(n-2)

print(f"Calculating fib(10): {fib(10)}")

view raw JSON →