First: Download GRAKN.AI
For more information on how to download older versions of GRAKN.AI, compile from source code, or import the Grakn Java API library as a development dependency, please visit our Downloads page.
GRAKN.AI requires Oracle Java 8 (Standard Edition) with the
$JAVA_HOMEset accordingly. If you don’t already have this installed, you can find it here.
If you intend to build Grakn from source code, or develop on top of it, you will also need Maven 3.
If you are looking for information about setting up a production deployment of GRAKN.AI, please see the deployment guide.
Unzip the download into your preferred location and run the following in the terminal to start Grakn:
cd [your Grakn install directory] ./bin/grakn.sh start
On macOS, you can install it using the
brew package manager. Binaries will be added to your path:
brew install grakn grakn.sh start
This will start:
- an instance of Cassandra, which serves as the supported backend for Grakn.
- Grakn Engine, which is an HTTP server providing batch loading, monitoring and the browser dashboard.
To start Grakn, run
To stop Grakn, run
To remove all graphs from Grakn, run
Grakn Engine is configured by default to use port 4567, but this can be changed in the grakn-engine.properties file, found within the /conf directory of the installation.
Test the Graql Shell
To test that the installation is working correctly, we will load a simple ontology and some data from a file and test it in the Graql shell and Grakn visualiser. The file we will use is basic-genealogy.gql, which is included in the /examples folder of the Grakn installation zip.
Type in the following in the terminal to load the example graph. This starts the Graql shell in non-interactive mode, loading the specified file and exiting after the load is complete.
./bin/graql.sh -f ./examples/basic-genealogy.gql
Then type the following to start the Graql shell in its interactive (REPL) mode:
The Graql shell starts and you see a
>>> prompt. Graql is our knowledge-oriented query language, which allows you to interface with Grakn. We will enter a query to check that everything is working.
match $x isa person, has identifier $n;
You should see a printout of a number of lines of text, each of which includes a name, such as “William Sanford Titus” or “Elizabeth Niesz”.
If you see the above output then congratulations! You have set up Grakn.
Test the Visualiser
The Grakn visualiser provides a graphical tool to inspect and query your graph data. You can open the visualiser by navigating to localhost:4567 in your web browser. The visualiser allows you to make queries or simply browse the knowledge ontology within the graph. The screenshot below shows a basic query (
match $x isa person;) typed into the form at the top of the main pane, and visualised by pressing “>” to submit the query:
You can zoom the display in and out, and move the nodes around for better visibility. Please see our visualiser documentation for further details.
Our Quickstart Tutorial will go into more detail about using Grakn and Graql.
You can find additional example code and documentation on this portal. We are always adding more and welcome ideas and improvement suggestions. Please get in touch!
Want to leave a comment? Visit the issues on Github for this page (you’ll need a GitHub account). You are also welcome to contribute to our documentation directly via the “Edit me” button at the top of the page.