smarr / truffle

The Truffle Language Implementation Framework

GraalVM

GraalVM is a universal virtual machine for running applications written in JavaScript, Python, Ruby, R, JVM-based languages like Java, Scala, Clojure, Kotlin, and LLVM-based languages such as C and C++.

The project website at https://www.graalvm.org describes how to get started, how to stay connected, and how to contribute.

Repository Structure

The GraalVM main source repository includes the components listed below. The documentation for each component includes developer instructions for the component.

• GraalVM SDK contains long term supported APIs of GraalVM.

• GraalVM compiler written in Java that supports both dynamic and static compilation and can integrate with the Java HotSpot VM or run standalone.

• Truffle language implementation framework for creating languages and instrumentations for GraalVM.

• Tools contains a set of tools for GraalVM languages implemented with the instrumentation framework.

• Substrate VM framework that allows ahead-of-time (AOT) compilation of Java applications under closed-world assumption into executable images or shared objects.

• Sulong is an engine for running LLVM bitcode on GraalVM.

• GraalWasm is an engine for running WebAssembly programs on GraalVM.

• TRegex is an implementation of regular expressions which leverages GraalVM for efficient compilation of automata.

• VM includes the components to build a modular GraalVM image.

• VS Code provides extensions to Visual Studio Code that support development of polyglot applications using GraalVM.

Get Support

• Open a GitHub issue for bug reports, questions, or requests for enhancements.
• Report a security vulnerability according to the Reporting Vulnerabilities guide.

Related Repositories

GraalVM allows running of following languages which are being developed and tested in related repositories with GraalVM core to run on top of it using Truffle and the GraalVM compiler. These are:

• GraalJS - JavaScript and Node.js
• FastR - R Language
• GraalPython - Python
• TruffleRuby - Ruby
• SimpleLanguage - A simple demonstration language for the GraalVM.

License

Each GraalVM component is licensed:

• Truffle Framework and its dependency GraalVM SDK are licensed under the Universal Permissive License.
• Tools project is licensed under the GPL 2 with Classpath exception.
• TRegex project is licensed under the Universal Permissive License.
• GraalVM compiler is licensed under the GPL 2 with Classpath exception.
• Substrate VM is licensed under the GPL 2 with Classpath exception.
• Sulong is licensed under 3-clause BSD.
• GraalWasm is licensed under the Universal Permissive License.
• VM is licensed under the GPL 2 with Classpath exception.
• VS Code extensions are distributed under the UPL 1.0 license.