Konnektr.AgeDigitalTwins 1.30.0

dotnet add package Konnektr.AgeDigitalTwins --version 1.30.0
                    
NuGet\Install-Package Konnektr.AgeDigitalTwins -Version 1.30.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Konnektr.AgeDigitalTwins" Version="1.30.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Konnektr.AgeDigitalTwins" Version="1.30.0" />
                    
Directory.Packages.props
<PackageReference Include="Konnektr.AgeDigitalTwins" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Konnektr.AgeDigitalTwins --version 1.30.0
                    
#r "nuget: Konnektr.AgeDigitalTwins, 1.30.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Konnektr.AgeDigitalTwins@1.30.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Konnektr.AgeDigitalTwins&version=1.30.0
                    
Install as a Cake Addin
#tool nuget:?package=Konnektr.AgeDigitalTwins&version=1.30.0
                    
Install as a Cake Tool

Konnektr Graph

Semantic Graph for Postgres

License Docs GitHub stars

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.$model payloads, same SELECT … FROM DIGITALTWINS query 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


Contributing

  1. Open an issue to discuss the change
  2. Branch, implement, and make sure dotnet test ./src --filter 'Category!=Integration' passes locally
  3. Open a pull request — the PostgreSQL 16/17/18 × stock/CloudNativePG matrix has to be green

Community


License

Apache License 2.0 — see LICENSE.

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed