GraalPy

Embed Python in JVM Applications with GraalPy

Python Packages in Java

Use Python packages directly in Java, Kotlin, or Scala

Jython Upgrade Path

Upgrade Jython projects to Python 3

JVM Scripting with Python

Script JVM applications with Python

How to Get Started

Add GraalPy as a dependency to your JVM application, or go straight to the starter project.

Without Python Dependencies

<dependencies>
  <dependency>
    <groupId>org.graalvm.polyglot</groupId>
    <artifactId>polyglot</artifactId>
    <version>25.0.2</version>
  </dependency>
  <dependency>
    <groupId>org.graalvm.polyglot</groupId>
    <artifactId>python</artifactId>
    <version>25.0.2</version>
    <type>pom</type>
  </dependency>
</dependencies>

import org.graalvm.polyglot.Context;

try (Context context = Context.newBuilder()
        .allowAllAccess(true) // See documentation for options
        .build()) {
    context.eval("python", "print('Hello from GraalPy!')");
}

dependencies {
    implementation("org.graalvm.polyglot:polyglot:25.0.2")
    implementation("org.graalvm.polyglot:python:25.0.2")
}

import org.graalvm.polyglot.Context;

try (Context context = Context.newBuilder()
        .allowAllAccess(true) // See documentation for options
        .build()) {
    context.eval("python", "print('Hello from GraalPy!')");
}

With Python Dependencies

<dependencies>
  <dependency>
    <groupId>org.graalvm.python</groupId>
    <artifactId>python-embedding</artifactId>
    <version>25.0.2</version>
  </dependency>
</dependencies>
<build>
  <plugins>
    <plugin>
      <groupId>org.graalvm.python</groupId>
      <artifactId>graalpy-maven-plugin</artifactId>
      <version>25.0.2</version>
      <executions>
        <execution>
          <configuration>
            <packages>
              <package>pyfiglet==1.0.2</package>
            </packages>
          </configuration>
          <goals>
            <goal>process-graalpy-resources</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

import org.graalvm.polyglot.Context;
import org.graalvm.python.embedding.GraalPyResources;

try (Context context = GraalPyResources.contextBuilder().build()) {
    context.eval("python", """
        from pyfiglet import Figlet
        f = Figlet(font='slant')
        print(f.renderText('Hello from GraalPy!'))
        """);
}

plugins {
    id "org.graalvm.python" version "25.0.2"
}

dependencies {
    implementation("org.graalvm.python:python-embedding:25.0.2")
}

graalPy {
    packages = ["pyfiglet==1.0.2"]
}

import org.graalvm.polyglot.Context;
import org.graalvm.python.embedding.GraalPyResources;

try (Context context = GraalPyResources.contextBuilder().build()) {
    context.eval("python", """
        from pyfiglet import Figlet
        f = Figlet(font='slant')
        print(f.renderText('Hello from GraalPy!'))
        """);
}