<p align="center">
  <img src="gno-logo.png" alt="Gno Logo" width="125" align="right">
</p>


# Gno

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

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

> *gnō-*, Proto-Indo-European root meaning "to know."
>
> -- [Etymonline](https://www.etymonline.com/word/*gno-)

Gno is an Elixir library that abstracts RDF dataset persistence across different storage backends, providing a single API for querying, updating, and managing RDF data regardless of the underlying SPARQL triple store. It uses [DCAT-R](https://w3id.org/dcatr) for its structural model and RDF-based configuration.


## Features

- **Unified SPARQL API** — query (`SELECT`, `ASK`, `CONSTRUCT`, `DESCRIBE`), update, and manage graphs through a single interface
- **Multiple store backends** — built-in adapters for Apache Jena Fuseki, Oxigraph, QLever, and Ontotext GraphDB, with a generic adapter for any SPARQL 1.1-compatible store
- **RDF-based configuration** — services, repositories, and stores are described in Turtle manifests using DCAT-R vocabulary, with environment-specific configs (dev/test/prod)
- **Changeset system** — structured representation of RDF changes with four actions (add, update, replace, remove) and automatic computation of minimal effective changes
- **Transactional commits** — changes applied atomically with automatic rollback on failure and an extensible middleware pipeline


## Getting Started

### Installation

For complete setup instructions including HTTP adapter configuration, store backend setup, and manifest configuration, see the [Installation guide](https://rdf-elixir.dev/gno-guide/installation).

### Quick Example

```elixir
# Query data
{:ok, result} = Gno.select("SELECT ?s ?p ?o WHERE { ?s ?p ?o }")

# Insert data
:ok = Gno.insert_data(EX.S |> EX.p(EX.O))

# Commit structured changes transactionally
{:ok, commit} = Gno.commit(
  add: EX.S1 |> EX.p(EX.O1),
  update: EX.S2 |> EX.p(EX.O2),
  remove: EX.S3 |> EX.p(EX.O3)
)
```

### Further Reading

**For a comprehensive guide** covering installation, configuration, querying, and data management, see the [User Guide](https://rdf-elixir.dev/gno-guide/).

**For detailed API documentation**, see the [HexDocs documentation](https://hexdocs.pm/gno).


## Consulting

If you need help with your Elixir and Linked Data projects, just contact [NinjaConcept](https://www.ninjaconcept.com/) via <contact@ninjaconcept.com>.


## Acknowledgements

<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/core" ><img src="https://nlnet.nl/logo/NGI/NGIZero-green.hex.svg" alt="NGI Zero Core Logo" height="150"></a></td>
<td><a href="https://jb.gg/OpenSource"><img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg" alt="JetBrains Logo" width="150"></a></td>
</tr>
</table>

This project is funded through [NGI Zero Core](https://nlnet.nl/core), 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://jb.gg/OpenSource) supports the project with complimentary access to its development environments.


## License and Copyright

(c) 2026 Marcel Otto. MIT Licensed, see [LICENSE](LICENSE.md) for details.