If you use Ubuntu, you can install Regent by running:
If you use macOS, you can install Regent by running:
Note: Previously we recommended Homebrew to install LLVM, but as of December 2020, this route does not work unless you have a full installation of XCode (i.e., the command-line tools are not sufficient).
Complete instructions for installation follow below.
Regent is also available as a Docker container. See the bottom of this page for instructions.
There are also a number of optional dependencies. For most users, we recommend skipping these initially and installing them later on an as-needed basis.
Regent includes a self-installer which downloads Terra and builds the Regent compiler. Run:
For other installation options (including multi-node and GPU configurations), see the README.
Regent includes a frontend interpreter which can be run with:
(Note: The Regent frontend can also be run without arguments to obtain a Terra/LuaJIT shell. However, this mode is not very useful because of the way that Terra language extensions works. Also, the Legion runtime is not currently reentrant, making interactive use difficult.)
Regent syntax highlighting modes are available for the following editors:
If you have Docker, Regent is also available as a container:
This will start a bash shell from which you can run Regent. Regent is installed under
/usr/local/legion. So for example, to run the circuit example:
Because Docker containers have no access to the host file system, some additional options are required if you want to run Docker on your own Regent files. The command below mounts the current directory in the host as
/examples in the container and then runs Regent on it.