README.md

Awesome Graal

---

CircleCI: Graal JDK8 (Linux) | GraalVM Suite JDK8 (Linux)
AdoptOpenJDK build farm: Linux ⚫ MacOS ⚫ Windows

---

Graal compiler (JDK8, python 2.7, 3.6 & 3.7): | GraalVM Suite (JDK8, python 2.7, 3.6 & 3.7): | Dataiku DSS on GraalVM: | Grakn on GraalVM: | Jupyter-Java on GraalVM: | MLPMNist using DL4J on GraalVM: | Zeppelin on GraalVM:

---

A curated list of awesome resources for Graal, GraalVM, Truffle and related topics.

This repo is dedicated to computer engineers/scientists, compiler/VM engineers, developers, open-source enthusiatics, Graal/GraalVM/Truffle fans and all other professions that take interest in these topics. To make learning interesting and to create a place to easily find all the necessary material. Please contribute, watch, star, fork and share the repo with others in your community.

• Awesome Graal
  • Languages & Platforms
  • Related JEPs
  • Community
  • Github links
  • Mercurial links
  • Download links
  • Projects, Wikipedia pages, discussion forums & blog posts
  • Papers, presentations/slides & videos
  • Hands-on pages
  • Special topics
• Contributing

Languages & Platforms

Java & other JVM languages

• Why?
• Getting Started: Running Java
• Examples
  • Dataiku Data Science Studio | folder
  • Java Performance Examples
  • Java stream API benchmark
  • Grakn/Graql graph database running on the GraalVM and other JVMs | folder
  • Java/Kotlin Native Example
  • Native Image Example
  • Native-image: using Profile Guide Optimisation options | Slide 18
  • Command line apps with Clojure and GraalVM
  • GraalVM Polyglot with Clojure and JavaScript
  • Clojure: GraalVM Native Image HTTPS Support
  • Building native Clojure images with GraalVM
  • Clojure Hello World example | folder
  • GraalVM with Groovy | native image
  • GraalVM and Scala | Scala compiler faster & slimmer
  • Scala-days-2018 demo
• Compatibility
• GraalVM Updater
• Reference Manual: JVM languages
• Polyglot Reference | Top 10 Things To Do With GraalVM
• Tools Reference
• Native Images

Python, R, Ruby

• Why?
• Get Started: Running Python
• Get Started: Running R
• Get Started: Running Ruby
• Examples
  • JavaScript, Java, R Polyglot Application
  • R's graphical output in Java based desktop application
  • FastR Node.js interop example
  • A simple, straightforward implementation of "Conway's Game of Life"
  • rJava package and built-in Java interoperability in FastR
  • Embedding R as a scripting language into JVM applications
  • Weather Predictor Application: R, Ruby, Java, NodeJS/JS
  • GraalVM demos: Another Polyglot JavaScript, Java, R application
  • Galaaz Demo: GraalVM, TruffleRuby, FastR, ggplot2, gridExtra
  • GraalVM demos: Polyglot JavaScript, Java, R application
  • GraalVM demos: Spring Boot using R packages demo
• Compatibility
• GraalVM Updater
• Reference Manual: Python
• Reference Manual: R
• Reference Manual: Ruby
• Polyglot Reference | Top 10 Things To Do With GraalVM
• Tools Reference
• Native Images

JRuby

• Running JRuby on the Graal JIT

Javascript / NodeJS

• Why?
• Getting Started
• Examples
  • JavaScript, Java, R Polyglot Application
  • Running JavaScript Functions as Stored Procedures in Database
  • Oracle Database Example
  • GraalVM demos: Another Polyglot JavaScript, Java, R application
  • Galaaz Demo: GraalVM, TruffleRuby, FastR, ggplot2, gridExtra
  • GraalVM demos: Polyglot JavaScript, Java, R application
• GraalVM Updater
• Compatibility
• Reference Manual

Polyglot

• Getting started: combined languages
• Examples
  • Polyglot JavaScript, Java, R application
  • GraalVM Polyglot with Clojure and JavaScript
• Language Compatibility Tool
• GraalVM Updater
• Reference Manual | Top 10 Things To Do With GraalVM
• GraalVM as a platform: Embed languages
• IPolyglot: A polyglot Jupyter kernel for the GraalVM | HPI Polyglot Programming Seminar by Fabio Niephaus

LLVM

• Getting Started
• Compatibility
• Reference Manual | Top 10 Things To Do With GraalVM

Wasm

• Awesome WebAssembly Runtimes
• Towards a WebAssembly standalone runtime on GraalVM
• Running WebAssembly on the JVM
  • asmble: Compile WebAssembly to JVM and other WASM tools
  • Gradle-plugin
• Discussions on oracle/graal GitHub
  • WebAssembly and GraalVM
  • Compiling via Emscripten
  • wasm, wat and wasm2c conversations
• GraalWASM: current WebAssembly for GraalVM work by the good folks from the GraalVM team
• WebAssembly for Java developers: slides, code and Talk: Devoxx/VoxxedDays video by Dmitry Alexandrov
• Talk: Rust, WebAssembly, and the future of Serverless by Steve Klabnik
• Talk: An Introduction to WebAssembly by Guy Royse
• Blog: GraalVM now supports WebAssembly!

native-image

• What is native-image?
• Docs
  • Substrate VM
  • Substrate VM: options
  • Substrate VM: reflection
• Reference manual
  • Ahead-of-time Compilation
  • Prerequisites
  • Image Generation Options
  • Generating Heap Dumps
• Security guide
• Other resources
  • Blogs
  • see 'Native-image' in Blog posts
  • Workshop resources
    • Kris Foster's talks at LJC
      • https://github.com/krisfoster/Native-Image-Workshop/
      • https://krisfoster.github.io/Native-Image-Workshop/
    • native-image workshop on 25th Nov 2019
• Examples
  • Native Image Examples
  • An example Clojure CLI HTTP/S client using GraalVM native image
  • A simple native HTTP server with GraalVM
  • Example of Akka HTTP server compiled with GraalVM native-image
  • GraalVM Native Image HTTPS Support
  • A 7MB native-image Java app that runs in 30ms and uses only 4MB of RAM!

Third-Party Language Implementations (not officially supported by GraalVM)

• SOMns, a Simple Newspeak Implementation
• grCUDA, Polyglot CUDA integration for the GraalVM
• GraalSqueak, a Squeak/Smalltalk bytecode interpreter with support for the Smalltalk programming environment

Your Platforms, languages and Tools

Your Platforms

• Why?
• Reference Manual
• GraalVM as a Platform
  • Embed Languages

Your Languages and Tools

• Why?
• Reference Manual
• Implement your language
  • Truffle Language Implementation Framework
  • Simple Language framework built using Truffle API
  • cesquivias's GitHub page on Truffle
    • Writing a Language in Truffle. Part 1: A Simple, Slow Interpreter
    • Writing a Language in Truffle. Part 2: Using Truffle and Graal
    • Writing a Language in Truffle. Part 3: Making my Language (Much) Faster
    • Writing a Language in Truffle. Part 4: Adding Features the Truffle Way
• Examples
  • implementation of the if statement
  • A SOM Smalltalk implemented on top of Oracle's Truffle Framework , also see http://som-st.github.io/
  • Mumbler is a lisp programming language
• Implement your tools

Performance (startup & runtime)

• Are We Fast Yet? Comparing Language Implementations with Objects, Closures, and Arrays - by @smarr
• Investigating startup with bytestacks
• Comparison bash script: graal
• Better Java Streams performance with GraalVM
• Under the hood of GraalVM JIT optimizations
• GraalVM 19.1: Compiling Faster
• Isolates and Compressed References: More Flexible and Efficient Memory Management via GraalVM
• GraalVM’s JavaScript engine on JDK11 with high performance
• Compiler Explorer - online IDE, run code, see asm, rustic compiler

Related JEPs

• JEP 317: Experimental Java-Based JIT Compiler - OpenJDK
• JEP 243: Java-Level JVM Compiler Interface - OpenJDK
• JEP 295: Ahead-of-Time Compilation
• ...others

Community

• graal-dev mailing list
• graal-changes mailing list
• GraalVM slack channel invite
• GraalVM slack channel
• Gitter channels are being phased out, please join the slack channels (links above)
  • Gitter channel: graal-core
  • Gitter channel: truffleruby

• Twitter list: Wholly Graal of Compilers

• GraalVM.org community

Github links

See Github links

Mercurial links

• OpenJDK Graal forest
• Compiler
• JavaScript parser
• JVM Compiler Interface for JDK8
• JVM Compiler Interface for JDK9
• Deprecated
  • Compiler (deprecated by graal-core)
  • Compiler (deprecated by graal)

Download links

• GraalVM.org Downloads
• Oracle Labs GraalVM
  • Programming Languages and Runtimes ...
  • Download
  • Learn more
  • Java
• Homebrew Tap for GraalVM: brew cask install graalvm/tap/graalvm-ce
• Graal and Truffle Builds (JDK8/OpenJDK8)
• jruby graal-vm-0.19 on Homebrew - Libraries.io

Projects, Wikipedia pages, discussion forums & blog posts

Project(s)

• OpenJDK: Graal

Wikipedia page(s), OpenJDK Wiki, collection of useful links

• Graal (compiler) - Wikipedia
• OpenJDK Graal - Wiki
• Graal/GraalVM/Truffle official docs
  • Graal/GraalVM/Truffle Getting Started
• Graal/GraalVM/Truffle official Reference Manual
• OpenJDK Graal - Publications and Presentations
• GraalVM: Official list of publications
• GraalVM in the press
• Official FAQ on Graal/GraalVM/Truffle
• List of useful resources from Stefan Marr

Discussion forum(s)

• Graalvm (Programming) Questions & Answers - TechQA
• Oracle's Graal-JVM / Truffle for Scala? : scala - Reddit
• Reddit discussions on GraalVM and Scala
• Graal and Clojure discussions
• JIT compiling a subset of Python to x86-64

Blog posts

See Blog posts

Papers, presentations/slides & videos

See Papers, presentations/slides & videos

Hands-on pages

• General

  • Building Wholly Graal with Truffle!
  • How to build Graal-enabled JDK8 on CircleCI?

• Graal

  • Add Graal JIT Compilation to Your JVM Language in 5 Easy Steps ...

• GraalVM

  • GraalVM - APIDesign
  • Learning to use Wholly GraalVM! [reblogged on Java Advent Calendar]

• Truffle

  • LuaTruffle

• FastR

  • Compile and configure FastR in Linux | snatverk

Special topics (Java, Graal, GPUs, Accelerators, etc...)

See Special topics

Contributing

Contributions are very welcome, please share back with the wider community (and get credited for it)!

Please have a look at the CONTRIBUTING guidelines, also have a read about our licensing policy.