KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

ontogen

★ 42 Open GitHub ↗

A version control system for RDF datasets

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Hex.pm](https://img.shields.io/hexpm/v/ontogen.svg?style=flat-square)](https://hex.pm/packages/ontogen)
[![Hex Docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/ontogen/)
[![License](https://img.shields.io/hexpm/l/ontogen.svg)](https://github.com/ontogen/ontogen/blob/main/LICENSE.md)

[![ExUnit Tests](https://github.com/ontogen/ontogen/actions/workflows/elixir-build-and-test.yml/badge.svg)](https://github.com/ontogen/ontogen/actions/workflows/elixir-build-and-test.yml)
[![Quality Checks](https://github.com/ontogen/ontogen/actions/workflows/elixir-quality-checks.yml/badge.svg)](https://github.com/ontogen/ontogen/actions/workflows/elixir-quality-checks.yml)

<h2 align="center">Ontogen</h2>

<p align="center">
    A version control system for RDF datasets
    <br />
    <a href="https://ontogen.io"><strong>Explore the docs »</strong></a>
    <br />
    <br />
    <a href="https://github.com/ontogen/ontogen/blob/main/CHANGELOG.md">Changelog</a>
    ·
    <a href="https://github.com/ontogen/ontogen/issues">Report Bug</a>
    ·
    <a href="https://github.com/ontogen/ontogen/issues">Request Feature</a>
    ·
    <a href="https://github.com/ontogen/ontogen/discussions">Discussions</a>
  </p>
</div>

## About the Project

Ontogen is a version control solution. While it takes a lot of inspiration from Git, it is something very different, however. Whereas Git, Mercurial, SVN etc. are all version control systems for source code, Ontogen has a different versioning subject: datasets. These are datasets of data that were created or generated by someone or something, then reviewed by someone or something, then edited by someone or something and so on. So, while we can say Git, Mercurial, SVN are all SCM (Source-Control-Management) solutions, Ontogen would be a DCM (Data-Control-Management) solution.

But it's not about datasets in general. The versioned subject of Ontogen are the graphs of an RDF dataset that are stored in a SPARQL-star-compliant triple store. In an Ontogen repository on such a store, however, we have a similar situation as in Git: instead of a single `.git` directory containing the version history of the code, we have a single separated named graph containing the version history of the dataset.

Ontogen takes a holistic approach to RDF data versioning by considering not just the syntactical and semantical levels, but also the pragmatic layer, the acts of producing the data and changing them.

Key features of Ontogen include:

- Provenance metadata generation for changes in the triple store
- Incorporation of speech act utterances of RDF statements
- Integration with PROV and DCAT models

### Current Limitations

While Ontogen aims to provide a robust version control system for RDF datasets, it's important to note its current limitations:

1. **Single Graph Support**: The current version only supports versioning of individual graphs within an RDF dataset. Versioning of multi-graph datasets is not yet implemented.
2. **Cryptic Graph Names**: Due to the current implementation, graph names are automatically generated UUID URIs and can not be changed.
3. **Limited Configuration Updates**: There's currently no way to update and sync repository metadata and configuration from the configuration files in the file system with the respective copy in the store, after the initial repository setup.
4. **Performance with Large Datasets**: Ontogen is not yet suitable for versioning large datasets. Adding substantial amounts of data in a single commit can hit query size limits in some triple stores. Additionally, certain queries become prohibitively slow with very large datasets (be sure to use the latest version to at least prevent timeouts).

I'm actively working on addressing these limitations in future versions. The first three points will be addressed during the current follow-up funding period by the NLnet Foundation. For now, Ontogen is best suited for smaller to medium-sized datasets and experimental use.

## Getting Started

> **Note for end users:** This is the core library, which can be used to integrate Ontogen into your Elixir apps. If you're looking to use Ontogen as a command-line tool, please check out the [Ontogen CLI](https://github.com/ontogen/cli) repository.

### Prerequisites

To use Ontogen, you'll need:

- Elixir v1.15+ & Erlang/OTP v23+
- A SPARQL-compatible triple store (currently only Fuseki and Oxigraph are officially supported)

### Installation

Add Ontogen to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:ontogen, "~> 0.1"}
  ]
end
```

Then run:

```
$ mix deps.get
```

## Usage

Here's a basic example of how to use Ontogen with its CLI:

```sh
$ mkdir example
$ cd example

$ og init --adapter Oxigraph
Initialized empty Ontogen repository in /Users/JohnDoe/example

$ og setup
Set up Ontogen repository

$ og add data.ttl

$ og commit --message "Initial commit"
[(root-commit) 6fc09c94768204983d0409d28e0796ec3f17cef46e57c5cb1248424d3922040d] Initial commit
 3 insertions, 0 deletions, 0 overwrites

$ og log --changes
ec8108e3f4 - Initial commit (just now) <John Doe john.doe@example.com>
   <http://www.example.org/employee38>
 +     <http://www.example.org/familyName> "Smith" ;
 +     <http://www.example.org/firstName> "John" ;
 +     <http://www.example.org/jobTitle> "Assistant Designer" .
```

_For more examples, please refer to the [User Guide](https://ontogen.io/docs/user-guide/)_

## Roadmap

- [ ] Support for multiple graphs in an RDF dataset
- [ ] Implement branching and merging capabilities
- [ ] Support for more triple stores
- [ ] ...

See the [open issues](https://github.com/ontogen/ontogen/issues) for a full list of proposed features (and known issues).

## Contact

Marcel Otto - [@marcelotto@mastodon.social](https://mastodon.social/@marcelotto) - [@MarcelOttoDE](https://twitter.com/MarcelOttoDE) - marcelotto@gmx.de

## Acknowledgments

<table style="border: 0;">  
<tr>  
<td><a href="https://nlnet.nl/"><img src="https://nlnet.nl/logo/banner.svg" alt="NLnet Foundation Logo" height="100"></a></td>  
<td><a href="https://nlnet.nl/assure" ><img src="https://nlnet.nl/logo/NGI/NGIAssure.purpleblue.hex.svg" alt="NGI Assure Logo" height="150"></a></td>  
<td><a href="https://www.jetbrains.com/?from=RDF.ex"><img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg" alt="JetBrains Logo" height="150"></a></td>  
</tr>  
</table>  
  
This project is funded through [NGI Assure](https://nlnet.nl/assure), a fund established by [NLnet](https://nlnet.nl/) with financial support from the European Commission's [Next Generation Internet](https://ngi.eu/) program.
  
[JetBrains](https://www.jetbrains.com/?from=RDF.ex) supports the project with complimentary access to its development environments.

## License

Distributed under the MIT License. See `LICENSE.md` for more information.

ontogen

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README