- Download the latest version GraalVM Community from https://github.com/graalvm/graalvm-ce-builds/releases/ currently it's 21.3.0.
- Extract the archive
tar -xvzf Downloads/graalvm-community-jdk-17.0.8_linux-x64_bin.tar.gz
sudo mv graalvm-community-openjdk-17.0.8+7.1/ /usr/lib/jvm- run
update-alternatives --config java
update-alternatives --config java
# you should see something like this
Selection Path Priority Status
------------------------------------------------------------
0 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 auto mode
* 1 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 2 manual mode
2 /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java 1081 manual mode
Press <enter> to keep the current choice[*], or type selection number:
- Add a new Java configuration
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/bin/java 1111now you should see a new Java configuration
sudo update-alternatives --config java
There are 5 choices for the alternative java (providing /usr/bin/java).
Selection Path Priority Status
------------------------------------------------------------
0 /usr/lib/jvm/java-19-openjdk-amd64/bin/java 1911 auto mode
* 1 /usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/bin/java 1111 manual mode
2 /usr/lib/jvm/java-11-openjdk-amd64/bin/java 1111 manual mode
3 /usr/lib/jvm/java-17-openjdk-amd64/bin/java 1711 manual mode
4 /usr/lib/jvm/java-19-openjdk-amd64/bin/java 1911 manual mode
5 /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java 1081 manual mode
Press <enter> to keep the current choice[*], or type selection number:
- Quick test: run
java --version
openjdk 17.0.8 2023-07-18
OpenJDK Runtime Environment GraalVM CE 17.0.8+7.1 (build 17.0.8+7-jvmci-23.0-b15)
OpenJDK 64-Bit Server VM GraalVM CE 17.0.8+7.1 (build 17.0.8+7-jvmci-23.0-b15, mixed mode, sharing)- Add a new javac version
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/bin/javac 1111
sudo update-alternatives --config javac
There are 5 choices for the alternative javac (providing /usr/bin/javac).
Selection Path Priority Status
------------------------------------------------------------
0 /usr/lib/jvm/java-19-openjdk-amd64/bin/javac 1911 auto mode
* 1 /usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/bin/javac 1111 manual mode
2 /usr/lib/jvm/java-11-openjdk-amd64/bin/javac 1111 manual mode
3 /usr/lib/jvm/java-17-openjdk-amd64/bin/javac 1711 manual mode
4 /usr/lib/jvm/java-19-openjdk-amd64/bin/javac 1911 manual mode
5 /usr/lib/jvm/java-8-openjdk-amd64/bin/javac 1081 manual mode
Press <enter> to keep the current choice[*], or type selection number: 5Update .bashrc profile
# open .bashrc file with an editor of your choice, e.g. VIM.
sudo vim ~/.bashrc
# add the following line at the bottom of the file
export PATH=$PATH:/usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/lib/installer/binrun gu available
Downloading: Component catalog from www.graalvm.org
ComponentId Version Component name Stability Origin
---------------------------------------------------------------------------------------------------------------------------------
espresso 23.0.1 Java on Truffle Supported github.com
espresso-llvm 23.0.1 Java on Truffle LLVM Java librSupported github.com
icu4j 23.0.1 ICU4J Supported github.com
js 23.0.1 Graal.js Supported github.com
llvm 23.0.1 LLVM Runtime Core Supported github.com
llvm-toolchain 23.0.1 LLVM.org toolchain Supported github.com
native-image-llvm-backend23.0.1 Native Image LLVM Backend Early adopter (experimental) github.com
nodejs 23.0.1 Graal.nodejs Supported github.com
python 23.0.1 GraalVM Python Experimental github.com
regex 23.0.1 TRegex Supported github.com
ruby 23.0.1 TruffleRuby Experimental github.com
visualvm 23.0.1 VisualVM Supported github.com
wasm 23.0.1 GraalWasm Experimental github.com
run the following:
gu install llvm-toolchaingu install native-imagegu install python
ln -s /usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/languages/python/bin/graalpy graalpython./graalpython -m venv graalenv
source graalenv/bin/activate- Installing packages you should be able to install most of common packages found on pypi with
pip, however; there are some packages that might not be compatible. Some of these packages can be patched and made available. rungraalpython -m ginstall install --helpto see such packages and install them viagraalpythonif they can't be installed directly via pip. Please, also see item 4 in the Possible Gotchas section down below if you encounter some issues.
graalpython -m ginstall install pandasSuppose you have a Python module at /path/to/file/your_module.py that does some computation with numpy e.g.
# your_module.py
import site # required!
import numpy as np
import pandas as pd
def compute_total_with_numpy(*nums):
return float(np.array(nums).sum())
def compute_total_with_pandas(*nums):
return float(pd.DataFrame(nums).sum())
def compute_total_with_pure_python(*nums):
return sum(nums)then to use it from within Java you can do something as follows:
// GraalPython.java
package org.vspaz.bindings;
import org.graalvm.polyglot.Context;
import org.graalvm.polyglot.Source;
import org.graalvm.polyglot.Value;
import java.io.File;
import java.io.IOException;
public class GraalPython {
private final Context ctx;
public GraalPython(String pythonModulePath) {
ctx = Context.newBuilder().allowAllAccess(true).build();
try {
ctx.eval(Source.newBuilder("python", new File(pythonModulePath)).build());
} catch (IOException e) {
e.printStackTrace();
}
}
public Value runPythonMethod(String pythonFunction, Object[] args) {
return ctx.getBindings("python").getMember(pythonFunction).execute(args);
}
}
// Main.java
import org.vspaz.bindings.GraalPython;
public class Main {
public static void main(String[] args) {
GraalPython bindings = new GraalPython("/path/to/your_module.py");
Object[] nums = {1.0, 2.23, 3.49494, 4.40404, 5.10110, 181.101, 133.11};
assert bindings.runPythonMethod("compute_total_with_pandas", nums).asDouble() == 330.44108;
assert bindings.runPythonMethod("compute_total_with_numpy", nums).asDouble() == 330.44108;
assert bindings.runPythonMethod("compute_total_with_pure_python", nums).asDouble() == 330.44108;
}
}Suppose you have a Java class e.g.
// StringOps.java
public class StringOps{
public String multiply(String text, int times) {
return String.valueOf(text).repeat(Math.max(0, times));
}
}then compile it
javac StringOps.java# java_from_python.py
import java
string_ops = java.type("StringOps")()
assert "abcabcabcabcabc" == string_ops.multiply("abc", 5)graalpython --jvm --vm.cp=. java_from_python.py
# or if you set up a graalpython venv, then e.g.
source graalenv/bin/activate
python --jvm --vm.cp=. java_from_python.py-
error
Downloading: Component catalog from www.graalvm.org
Error: Unknown component
solution: you might be running an old version of GraalVM; check the version.
-
error:
gu: command not found
solution: check if you can run
guby specifying the full path e.g../usr/lib/jvm/graalvm-community-openjdk-17.0.8+7.1/lib/installer/bin/gu. if it works, then check the path in .bashrc -
error:
graalpython: command not found see item 2.
-
error: pip can't install any package e.g. requests
solution: pip install distutils
-
error: scipy can't be installed
solution: make sure you have the following gfortran libopenblas-dev liblapack-dev installed, run
sudo apt-get install gfortran libopenblas-dev liblapack-dev