OntoBricks documentation
The full reference, mirrored from the project's master branch. New here? Start with the Getting Started guide.
Overview
OverviewOntoBricks DocumentationOntoBricks is a Graph Viewer Builder for the Databricks platform. It lets you design ontologies visually, map them to Unity Catalog tables, materialize a…
OverviewOntoBricks FeaturesA visual tour of everything OntoBricks does — ontology design, mapping, knowledge-graph build & explore, reasoning, GraphQL, MCP, and operations.
OverviewProduct & go-to-marketSlide-ready content for presenting OntoBricks to enterprise stakeholders. Each section maps to one slide or slide group.
OverviewOntoBricksOntoBricks builds a materialized graph viewer (triple store) from your Databricks tables using semantic web standards, graph databases, and formal reasoning:
Get started
Get startedOntoBricks User GuideOntoBricks is a visual tool for designing ontologies, mapping them to Databricks tables, generating R2RML mappings, synchronizing data to a triple store,…
Get startedExamplesThese walkthroughs take you from raw tables to an explorable graph viewer. Each one can be completed in 15–30 minutes.
Working with graphs
Working with graphsCohort DiscoveryCohort Discovery turns the question "which entities travel together?" into a deterministic, explainable, idempotent rule that any business user can author,…
Working with graphsRegistry Import / ExportOntoBricks provides two complementary ways to move domains between environments or share them with teammates:
Working with graphsData Access Wrappers — Engine MapThis document inventories every way the OntoBricks platform reads (or asks the backend to read) data, and pins each user-facing feature to the underlying…
Interfaces
InterfacesOntoBricks External REST APIThe OntoBricks REST API provides stateless endpoints for external applications to query ontologies and retrieve domain metadata.
InterfacesOntoBricks MCP ServerOntoBricks exposes its Knowledge Graph knowledge-graph capabilities via the Model Context Protocol (MCP), allowing LLM-based tools to browse domains,…
InterfacesRegister OntoBricks MCP in Unity Catalog and add it to Genie OneThis procedure registers the deployed OntoBricks MCP Databricks App as a Unity Catalog HTTP connection (with an optional MCP Service), then attaches that…
Architecture
ArchitectureOntoBricks ArchitectureOntoBricks is a web-based Graph Viewer Builder that runs natively on Databricks. The core workflow is:
ArchitectureAdding a New Graph DB EngineThis guide walks a developer through adding support for a new graph database engine to OntoBricks. It covers the architecture, the abstract contracts,…
ArchitectureLakebase as Graph DB — OntoBricks ReferenceOntoBricks ships with one built-in graph database engine: Lakebase Postgres. This document covers everything you need to provision, configure, and operate…
ArchitectureNeo4j Backend — Requirements & CompatibilityOntoBricks can store a domain's Knowledge Graph in Neo4j as a typed property graph (as opposed to the flat triple tables used by the Lakebase and Delta…
Deploy & operate
Deploy & operateOntoBricks Deployment GuideThis guide covers deploying OntoBricks both locally for development and to Databricks Apps for production use, including the optional MCP server for…
Deploy & operateOntoBricks — Databricks Automation BundleThe bundle configuration lives at the project root (databricks.yml) as required by the Databricks CLI. This directory contains supplementary documentation.
Deploy & operateOntoBricks Production Sizing QuestionnaireUse this questionnaire to collect the information needed to size a production OntoBricks deployment on Databricks. Complete all Required fields. Complete…
Deploy & operateOntoBricks deployment checklistUse this list before your first deploy (or when moving to a new workspace / instance). Automate most checks with:
Contributing
ContributingDevelopmentNotes for contributors: dependencies, testing, and permission / SDK notes.
ContributingOntoBricks code organization (for contributors)This document maps how the main OntoBricks application is wired: the browser UI, programmatic REST/GraphQL APIs, LLM agents, and the separate MCP server. It…
ContributingPR Review ChecklistStandalone reviewer reference. Cross-linked from .claude/skills/code-review/SKILL.md and .github/PULL_REQUEST_TEMPLATE.md.