GraalVM Demos

This repository contains demo applications and benchmarks written in Java, JavaScript, Python, R, Ruby, and other JVM languages such as Kotlin and Scala. These applications illustrate the diverse capabilities of GraalVM.

The demos are sorted by a framework, by a programming language, or by a technology. Each directory contains demo sources; the instructions on how to run a particular demo are in its README.md file. To get started, clone or download this repository, enter the demo directory, and follow steps in the README.md file.

git clone https://github.com/graalvm/graalvm-demos.git
cd graalvm-demos

GraalVM JDK and Native Image

Name	Description
hello-graal	Demonstrates how to build native executables from a class file and a JAR file from the command line Technologies: Native Image Reference: Native Image Getting Started
java-hello-world-maven	Demonstrates how to generate a native executable using the Native Build Tools Maven Plugin Technologies: Native Image, Native Build Tools Maven Plugin Reference: GraalVM Enterprise in OCI Code Editor
native-hello-module	Demonstrates how to build a modular Java application into a native executable Technologies: Native Image, Maven Reference: Build Java Modules into a Native Executable
native-list-dir	Demonstrates how to compile a CLI application into a native executable. The second part demonstrates how to build a polyglot (Java and JS) native executable. Technologies: Native Image, JavaScript Reference: Ahead-of-Time Compilation of Java and Polyglot Applications
java-simple-stream-benchmark	Demonstrates how the Graal compiler can achieve better performance for highly abstracted programs like those using Streams, Lambdas Technologies: Graal compiler, C2 Reference: Simple Java Stream Benchmark
streams	Demontrates how GraalVM efficiently optimizes the Java Streams API application and how to apply PGO Technologies: Native Image, Native Build Tools Maven Plugin Reference: Optimize a Native Executable with Profile-Guided Optimizations
fortune-demo	A fortune teller Unix program. Run it in JIT, build a native executable, or build a mostly-static native executable, using Gradle or Maven build tools. Technologies: Native Image, Native Build Tools Reference: Use GraalVM Dashboard to Optimize the Size of a Native Executable
multithreading-demo	Demonstrates how to optimize a Java application that does synchronous and asynchronous threads execution Technologies: Native Image, Native Build Tools Maven Plugin, GraalVM Dashboard Reference: Making sense of Native Image contents
native-image-configure-examples	Demonstrates how you can influence the classes initialization at the image build time Technologies: Native Image, Maven Reference: Understanding Class Initialization in GraalVM Native Image Generation
native-netty-plot	A web server application, using the Netty framework, to demonstrate the use of isolates with Native Image Technologies: Native Image, Maven, Netty Reference: Instant Netty Startup using GraalVM Native Image Generation
javagdbnative	Demonstrates how to debug a Java application, built into a native executable in VS Code Technologies: Native Image, Maven, GraalVM Tools for Java Reference: Native Image Debugging in VS Code

Java on Truffle (Espresso)

Name	Description
espresso-jshell	Demonstrates how to build a native executable of JShell, that executes the dynamically generated bytecodes on Espresso Technologies: Java on Truffle, Native Image, JShell Reference: Mixing AOT and JIT for Java, Java on Truffle — Going Fully Metacircular

Micronaut

Name	Description
micronaut-hello-rest-maven	Demonstrates how to package a Micronaut REST application into a native executable with Native Image Maven plugin Technologies: Native Image, Micronaut, Native Build Tools Maven Plugin Reference: Try in OCI Code Editor

Spring Boot

Name	Description
spring-native-image	Demonstrates how to turn a Spring Boot application into a native executable using Spring Native support Technologies: Spring Boot, Spring Native, Native Image Reference: GraalVM Native Image, Spring and Containerisation, GraalVM Enterprise in OCI Cloud Shell
spring-r	Demonstrates GraalVM's polyglot feature by loading an R script into a Java host application Technologies: Spring, FastR Reference: Enhance your Java Spring application with R data science

Helidon

Name	Description
js-java-async-helidon	An HTTP web service that demonstrates how multiple JavaScript contexts can be executed in parallel to handle asynchronous operations with Helidon in Java Technologies: Native Image, Helidon Reference: Asynchronous Polyglot Programming in GraalVM Using Helidon and JavaScript

Scala

Kotlin

Name	Description
java-kotlin-aot	Demonstrates how to interoperate between Java and Kotlin and build a native executable Technologies: Native Image, Kotlin, Maven Reference: Build a Native Image of a Java and Kotlin Application

Python

Name	Description
graalpy-notebook-example	Demonstrates how to embed Python in a Java application running on GraalVM Technologies: GraalPy

Polyglot

Name	Description
polyglot-chat-app	Demonstrates how to build a polyglot chat application by embedding Python and R into the Java host language Technologies: Java, GraalPy, FastR, Micronaut
polyglot-debug	Demonstrates how to debug a polyglot Java and JavaScript application using GraalVM extensions for VS Code Technologies: Java, JavaScript, Maven, GraalVM Extension Pack
polyglot-javascript-java-r	Demonstrates the polyglot capabilities of GraalVM and how to run a JavaScript-Java-R application Technologies: JavaScript, Node.js, Java, R Reference: Top 10 Things To Do With GraalVM
functionGraphDemo	Demonstrates how to run a polyglot JavaScript-Java-R application on GraalVM Node.js runtime Technologies: JavaScript, Node.js, Java, R

Compatibility

The demos are normal applications and benchmarks written in Java, JavaScript, Python, etc., so they are compatible with any virtual machine capable of running Java, JavaScript and so on. These demos are tested against the latest GraalVM release using GitHub Actions. If you come accross an issue, please submit it here.

License

Unless specified otherwise, all code in this repository is licensed under the Universal Permissive License (UPL). Note that the submodule fastR-examples which is a reference to the graalvm/examples repository has a separate license.

Learn More

• GraalVM website
• Graal project on GitHub
• GraalVM blog