This repository contains demo applications and benchmarks written in Java, JavaScript, Python, and other languages. 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
| Name | Description |
|---|---|
tiny-java-containers
| Demonstrates how to build very small Docker container images with GraalVM Native Image and various lightweight base images. Technologies: Native Image, musl libc Reference: Static and Mostly Static Images |
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: Oracle GraalVM 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 and then apply Profile-Guided Optimizations (PGO) for more performance gains Technologies: Native Image, PGO |
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 |
native-image-logging-examples |
Demonstrates how to initialize Loggers with Native Image at the executable build or run time Technologies: Native Image Reference: Add Logging to a Native Executable |
native-jfr-demo |
Demonstrates how to create a custom JDK Flight Recorder (JFR) event and use that in a native executable Technologies: Native Image, JFR, VisualVM Reference: Build and Run Native Executables with JFR |
native-shared-library |
Demonstrates how to create a Java class library, use Native Image to create a native shared library, and then create a small C application that uses that shared library Technologies: Native Image, LLVM toolchain Reference: Build a Native Shared Library |
native-image-reflection-example |
Demonstrates how to provide metadata for Native Image in the form of JSON configuration files using a tracing agent Technologies: Native Image |
native-static-images |
Demonstrates how to build a fully static and a mostly-static native executable. Technologies: Native Image Reference: Build a Statically Linked or Mostly-Statically Linked Native Executable |
native-heapdump-examples |
Demonstrates different ways to generate a heap dump from a running native executable. Technologies: Native Image, VisualVM Reference: Create a Heap Dump from a Native Executable |
native-image-jmx-demo |
This demo covers the steps required to build, run, and interact with a native executable using JMX. Technologies: Native Image, JMX, VisualVM Reference: Build and Run Native Executables with Remote JMX |
| Name | Description |
|---|---|
native-aws-fargate |
This demo covers the steps required to create a container image of a native executable application and deploy the image on AWS Fargate. Technologies: Native Image, Apache Maven, Docker, AWS Fargate |
native-aws-lambda |
This demo covers the steps required to deploy a native executable application on AWS Lambda. Technologies: Native Image, Apache Maven, Docker, AWS Lambda |
native-google-cloud-run |
This demo covers the steps required to create a container image of a native executable application and deploy the image on Google Cloud Run. Technologies: Native Image, Apache Maven, Docker, Google Cloud CLI, Google Cloud Run |
native-oci-container-instances |
This demo covers the steps required to create a container image of a native executable application and deploy the image on OCI Container Instances. Technologies: Native Image, Apache Maven, Docker, OCI Container Instances |
| 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 |
| Name | Description |
|---|---|
micronaut-hello-rest-maven |
Demonstrates how to package a Micronaut REST application into a native executable with Native Build Tools Maven plugin Technologies: Native Image, Micronaut, Native Build Tools Maven plugin Reference: Try in OCI Code Editor |
| Name | Description |
|---|---|
spring-native-image |
Demonstrates how to compile a Spring Boot application into a native executable using the Native Build Tools Maven plugin and a Maven profile Technologies: Spring Boot, Native Image, Native Build Tools Maven plugin Reference: GraalVM Native Image, Spring and Containerisation, Oracle GraalVM 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 |
| 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, Native Build Tools Maven plugin Reference: Asynchronous Polyglot Programming in GraalVM Using Helidon and JavaScript |
| Name | Description |
|---|---|
| scalac-native | Demonstrates how to build a native executable of the Scala compiler. The resulting binary has no dependencies on the JDK. Technologies: Scala 2.12.x, Native Image Reference: Compiling Scala Faster with GraalVM |
| Name | Description |
|---|---|
java-kotlin-aot |
Demonstrates how to interoperate between Java and Kotlin and build a native executable Technologies: Native Image, Kotlin, Maven |
| Name | Description |
|---|---|
graalpy-notebook-example |
Demonstrates how to embed Python in a Java application. It creates a Python `venv`, and installs required Python packages through a Maven configuration. Technologies: GraalPy |
graalpy-embedding-demo |
Demonstrates how to embed GraalPy in a Java application using Maven. Technologies: GraalPy |
| 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 Tools for Java in 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 the GraalVM Node.js runtime Technologies: JavaScript, Node.js, Java, R |
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.
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.