Konnektr.AgeDigitalTwins
1.30.0
dotnet add package Konnektr.AgeDigitalTwins --version 1.30.0
NuGet\Install-Package Konnektr.AgeDigitalTwins -Version 1.30.0
<PackageReference Include="Konnektr.AgeDigitalTwins" Version="1.30.0" />
<PackageVersion Include="Konnektr.AgeDigitalTwins" Version="1.30.0" />
<PackageReference Include="Konnektr.AgeDigitalTwins" />
paket add Konnektr.AgeDigitalTwins --version 1.30.0
#r "nuget: Konnektr.AgeDigitalTwins, 1.30.0"
#:package Konnektr.AgeDigitalTwins@1.30.0
#addin nuget:?package=Konnektr.AgeDigitalTwins&version=1.30.0
#tool nuget:?package=Konnektr.AgeDigitalTwins&version=1.30.0
Konnektr Graph
Semantic Graph for Postgres
Konnektr Graph is a semantic graph engine for PostgreSQL, built on Apache AGE. It stores DTDL-modelled entities as graph vertices, answers Cypher natively, and exposes an HTTP API that is compatible with Azure Digital Twins — so existing ADT SDKs, query strings and payloads keep working.
It is self-hosted: you run it on your own Kubernetes cluster, against your own database.
Why this exists
The graph is the product. "Digital twin" is a compatibility profile on top of it — one way to use the same data model, not a separate product.
- Azure Digital Twins compatible — same API surface, same DTDL models, same
$dtId/$metadata.$modelpayloads, sameSELECT … FROM DIGITALTWINSquery dialect. Existing .NET, Python, JavaScript and Java ADT clients connect unchanged. - A graph, not a document store — entities and relationships are vertices and edges, so traversals are Cypher instead of application-side joins.
- One database to operate — AGE runs inside PostgreSQL, next to your relational data, with normal backups, replication and tooling.
- Change streams you own — state changes publish to Kafka, Azure Data Explorer or MQTT through configurable event sinks and routes.
- Vocabulary-neutral surface — the same resources answer on
/entities/*as well as/digitaltwins/*, for domains that have nothing to do with twins.
Quick start
helm install graph oci://ghcr.io/konnektr-io/charts/graph \
--namespace graph --create-namespace \
--set api.enabled=true \
--set cluster.enabled=true \
--set api.config.authentication.enabled=false
Then follow the quickstart to upload a DTDL model, create a twin and query it.
Both api.enabled and cluster.enabled default to false, so a bare helm install
creates nothing. Pass -f values.yaml for anything real; the chart's values.yaml is the
authoritative reference.
The Azure Digital Twins profile
| Surface | Behaviour |
|---|---|
| Twin & relationship CRUD | ADT REST shapes (/digitaltwins/{id}, relationships, components) |
| Query | ADT SQL-like dialect translated to Cypher (POST /query) |
| Models | DTDL v2/v3 upload, decommission, dependency-aware delete |
| Payloads | $dtId, $metadata.$model, $lastUpdateTime; opt-in $lastUpdatedBy |
| SDKs | any client that speaks to Azure Digital Twins over HTTP |
Extensions beyond ADT — the native Konnektr.AgeDigitalTwins .NET SDK, direct database
access, scoped vector memory search — are opt-in and documented separately.
Components
| Component | Image | What it does |
|---|---|---|
| API | ghcr.io/konnektr-io/graph/graph-api |
HTTP surface: twins, models, query, import jobs |
| Events | ghcr.io/konnektr-io/graph/graph-events |
Consumes the WAL stream, publishes CloudEvents |
| Chart | oci://ghcr.io/konnektr-io/charts/graph |
API, Events and a CloudNativePG cluster |
Deployments before the 2026 rename pull the same images from
ghcr.io/konnektr-io/pg-age-digitaltwins/agedigitaltwins-*; those tags remain published.
Documentation
- Getting started
- Concepts — DTDL, querying, validation, events
- Self-hosted deployment
- Using the Azure Digital Twins SDKs
- SDK reference
Contributing
- Open an issue to discuss the change
- Branch, implement, and make sure
dotnet test ./src --filter 'Category!=Integration'passes locally - Open a pull request — the PostgreSQL 16/17/18 × stock/CloudNativePG matrix has to be green
Community
- GitHub Discussions — questions and ideas
- Issue tracker — bugs and feature requests
License
Apache License 2.0 — see LICENSE.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- DTDLParser (>= 1.1.3)
- JsonPatch.Net (>= 5.0.2)
- Konnektr.Npgsql.Age (>= 2.1.0)
- Microsoft.Extensions.Caching.Memory (>= 10.0.9)
-
net8.0
- DTDLParser (>= 1.1.3)
- JsonPatch.Net (>= 5.0.2)
- Konnektr.Npgsql.Age (>= 2.1.0)
- Microsoft.Extensions.Caching.Memory (>= 10.0.9)
- System.Text.Json (>= 10.0.9)
-
net9.0
- DTDLParser (>= 1.1.3)
- JsonPatch.Net (>= 5.0.2)
- Konnektr.Npgsql.Age (>= 2.1.0)
- Microsoft.Extensions.Caching.Memory (>= 10.0.9)
- System.Text.Json (>= 10.0.9)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.30.0 | 127 | 10/20/2026 |
| 1.29.4 | 109 | 10/12/2026 |
| 1.29.3 | 108 | 10/1/2026 |
| 1.29.2 | 126 | 9/18/2026 |
| 1.29.1 | 110 | 9/18/2026 |
| 1.29.0 | 101 | 9/18/2026 |
| 1.28.0 | 122 | 9/14/2026 |
| 1.27.2 | 175 | 9/4/2026 |
| 1.27.1 | 206 | 8/7/2026 |
| 1.27.0 | 118 | 8/6/2026 |
| 1.26.1 | 145 | 8/4/2026 |
| 1.26.0 | 137 | 7/27/2026 |
| 1.25.2 | 132 | 7/23/2026 |
| 1.25.1 | 132 | 7/15/2026 |
| 1.25.0 | 149 | 7/1/2026 |
| 1.24.5 | 149 | 6/17/2026 |
| 1.24.4 | 141 | 6/17/2026 |
| 1.24.3 | 140 | 6/10/2026 |
| 1.24.2 | 132 | 6/2/2026 |
| 1.24.1 | 138 | 6/2/2026 |