Build and Run Python Applications with GraalPy
High-Performance Python
Speed up Python applications with the Graal JIT compiler
Java Interoperability
Use Java libraries in Python applications
Install or Download
GraalPy is available for multiple platforms in two variants: Native (for a compact download size and smaller footprint) and JVM (for full Java interoperability). Distributions based on Oracle GraalVM provide the best performance and advanced features and are released under the GFTC license. Distributions based on GraalVM Community Edition, released under the OSI-approved UPL license, are available on GitHub. See Choosing a GraalPy Distribution for guidance on selecting the appropriate runtime.
# Latest GraalPy release
pyenv install graalpy-25.0.2
pyenv shell graalpy-25.0.2
# On Windows (pyenv-win), provide platform-specific names
pyenv install graalpy-25.0.2-windows-amd64
pyenv shell graalpy-25.0.2-windows-amd64
# Latest development build of GraalPy
pyenv install graalpy-dev
pyenv shell graalpy-dev
# Install GraalPy with uv (uv selects GraalPy by Python language version)
uv python install graalpy-3.12
# Create a virtual environment with GraalPy
uv venv --python graalpy-3.12
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: 'graalpy-25.0.2'
- run: python my_script.py
| Version | Kind | Linux (aarch64) | Linux (amd64) | macOS (aarch64) | Windows (amd64) |
|---|---|---|---|---|---|
| 25.0.2 | Native |
|
|
|
|
| JVM |
|
|
|
|
|
| Latest early access build | Native |
|
|
|
|
| JVM |
|
|
|
|
