GraalPy Extensions

March 18, 2026 ยท View on GitHub

Collection of tools and libraries that extend GraalPy, a high-performance embeddable Python 3 runtime.

GraalPy Embedding

Java library with utility classes useful when embedding GraalPy.

  • VirtualFileSystem: implementation of the FileSystem SPI backed by Java resources and tailored for use with GraalPy Maven/Gradle plugin (see below).
  • GraalPyResources: factory methods for creating a Context configured with the VirtualFileSystem.
  • PositionalArguments and KeywordArguments: provide way to pass positional and keyword arguments via the generic Context API.

See the GraalPy Embedding API Javadocs for the full class and module reference.

GraalPy Maven Archetype

Maven archetype to generate a Java project that embeds GraalPy.

mvn archetype:generate \
  -DarchetypeGroupId=org.graalvm.python \
  -DarchetypeArtifactId=graalpy-archetype-polyglot-app \
  -DarchetypeVersion=25.0.2

GraalPy Maven Plugin

Maven plugin to install and manage Python packages for embedded GraalPy. For more details see the user manual.

GraalPy Gradle Plugin

Gradle plugin to install and manage Python packages for embedded GraalPy. For more details see the user manual.

GraalPy JBang Integration

With this integration, one can add Python package dependencies using syntax similar to how Maven dependencies are added:

//PIP qrcode==7.4.2

For example, see GraalPy JBang QR Code demo.

GraalPy Sandboxed MCP Server

MCP server for executing Python code in a configurable sandbox. See the GraalPy Sandboxed MCP Server documentation for details.

GraalPy Sandboxed CLI

Sandboxed Python CLI for executing Python code in a configurable sandbox. See the GraalPy Sandboxed CLI documentation for details.

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide.

Security

Please consult the security guide for the responsible security vulnerability disclosure process.

License

Copyright (c) 2025, 2026 Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.