Documentation Walkthrough

Where to begin when working through the RAI documentation.

This guide is designed to help you work through our documentation in an optimal order, beginning with basic and proceeding to intermediate knowledge of RAI’s Relational Knowledge Graph Management System (RKGMS) and Rel, our declarative modeling language that lets you best make use of this system.

All our guides and tutorials can be downloaded as RAI Notebooks allowing you to get hands-on with the code.


To learn more about our Relational Knowledge Graph Management System (RKGMS) and how to interact with it, work through these guides in order:

  1. Quick Start – a short guide that describes how to begin working with our RKGMS using the RAI Console.
  2. Working with RAI Notebooks – a short guide to working with RAI Notebooks, which are where you code applications in the RAI Console.
  3. Managing Databases in the RAI Console – a short guide to managing databases in the RAI Console.
  4. Managing Engines in the RAI Console – a short guide to managing engines in the RAI Console.
  5. Get Started with the Python SDK – a short guide that describes how to use the RelationalAI SDK for Python to connect to RAICloud and use Rel through the SDK.


To learn more about Rel, our declarative modeling language, work through these guides in order:

Intro Tutorials

  1. My First Rel Program – a tutorial designed to to give you your first introduction to Rel.
  2. My First Knowledge Graph – a tutorial designed to give a first introduction to modeling and querying a knowledge graph in Rel.

Rel Primer

Our Rel Primer is designed for developers with programming experience.

  1. Basic Syntax – introduces the main features of Rel. The Primer assumes basic knowledge of database concepts and programming.
  2. Aggregations, Group-by, and Joins – introduces common database operations in Rel.
  3. Advanced Syntax – describes advanced aspects of the language, including overloading and higher-order syntax.

Data Handling

  1. CSV Import – demonstrates how to import data from a CSV file using Rel.
  2. JSON Import and Export – demonstrates how to import and export JSON data using Rel.
  3. Working with EDB Relations – describes how to save and update data in a RAI relational database using the Rel language.


  1. Installing Models – introduces the concept of an “installed Rel source”, which you can reuse later in queries or as a building block for modeling.
  2. Entities – introduces entities and shows how you define and use these throughout Rel.
  3. Modules – introduces modules as a way to organize and structure your modeling in Rel, and demonstrates basic syntax.
  4. Integrity Constraints – describes how you can use integrity constraints to ensure the accuracy and consistency of your data in the RAI database.
  5. Recursion – describes how you write and use recursive relations.

Rel in Action

  1. Machine Learning (Classification) – describes how you load a dataset, build a classification model, and perform predictions.
  2. Machine Learning (Regression) – describes how you load a dataset, build regression models using glm and mlpack bindings, and perform predictions.
  3. Modeling and Reasoning (OWL and Rel) – describes how you write Web Ontology Language (OWL) reasoning and SPARQL/RDF queries in Rel.

Go Further

We hope these two paths whet your appetite for RAI and the exciting things we’re building. For further learning, check out our whole selection of How-To and Concept Guides, as well as wider Reference material and our Rel Libraries.