GNOSIVELA-open

GNOSIVELA-open 鈥?Developer entry point and distribution surface (Apache-2.0).

涓枃鏂囨。

GNOSIVELA is AxisRobo's Enterprise Semantic & Knowledge Fabric: it turns how an enterprise defines concepts, unifies entity references, interprets relations, evidences claims, and governs conflicts into a consumable semantic layer. This repository is the public distribution surface: SDKs, examples, API contract, reference ontology, and binary releases.

The problem it solves

Enterprise knowledge is scattered across ERP / CRM / documents / data lakes / policy stores, and every agent, planner, or BI tool guesses at meaning on its own. The result:

• Same name, different meaning 鈥?three definitions of "Active Customer" coexist and no one knows which one is in use
• Split identities 鈥?the same supplier has 12 IDs across 12 systems; cross-source merging is left to luck
• Ungrounded answers 鈥?agents output plausible conclusions with no traceable source, time, or permission chain
• Silently overwritten conflicts 鈥?new data replaces old data instead of being kept as competing assertions
• Vendor lock-in 鈥?semantics get welded to the internal schema of a specific graph or vector store

GNOSIVELA's answer: define semantic objects first (Ontology / Assertion / Identity / Relation / Grounding), then decide on storage. The semantic control plane owns consistency and governance; the polyglot projection layer (SQL / Graph / Search / Vector) stays replaceable and never pollutes the semantic API.

Features

Capability	Description
Semantic Contract DSL	Declare concepts, properties, constraints, and relations; the DSL compiler generates SDK types + JSON Schema
Ontology Registry	Versioning / semantic diff / validation / publish / deprecate
Knowledge Assertion	Every claim carries source, time, context, status, confidence, and an evidence chain
Entity Identity	Cross-source entity resolution with exact-match and evidence-first merging; fuzzy matches are candidates only, never silently merged
Polyglot Projection	Same semantic object projected to Relational / Graph / Search / Vector; replaceable without exposing vendor types
Semantic Query	Intent parsing 鈫?joint retrieval across entities/relations/documents/metrics 鈫?purpose-scoped KnowledgeView with conflicts/gaps
Grounding (Phase 1 in progress)	Purpose-scoped Bundle assembly: intent + assertions + evidence + policy + conflict/gap

Open Core (three repositories)

Repository	Role	License
GNOSIVELA-open (this repo)	SDK, examples, API contract, binaries	Apache-2.0
GNOSIVELA	Product core (Semantic Kernel)	AGPL-3.0
GNOSIVELA-ee	Enterprise edition: governance, scale, industry packs	Enterprise

License compliance: the SDK in this repository is Apache-2.0 and interacts with the core over HTTP 鈥?it never links the AGPL core.

Repository layout

contracts/             # Semantic API contract (openapi.yaml) + DSL samples (examples/)
sdk/go/gnosivela/     # Go client SDK (contract DTOs generated by the DSL compiler)
sdk/go/gnosivela/gen/ # Domain types generated by the DSL compiler (Go struct + JSON Schema)
sdk/python/           # Python client SDK (standard-library only)
sdk/typescript/       # TypeScript client SDK (fetch-based, runs without a build step)
sdk/java/             # Java client SDK (JDK HttpClient, zero dependencies)
examples/             # End-to-end examples (quickstart)

Downloads

The control-plane server binary and container image are built from the GNOSIVELA Core repository (AGPL-3.0) and published on its GitHub Releases. This repository is the community download surface.

Artifact	Where
Prebuilt server binaries (linux-amd64 / linux-arm64 / darwin-arm64 / windows-amd64)	GNOSIVELA Core Releases (attach gnosivela-*, sha256sums.txt)
Container image	ghcr.io/axisrobo/GNOSIVELA:<tag> (tagged on every v* release; latest on the newest)
Go / Python / TypeScript / Java SDKs	this repository (sdk/, published to pypi/npm/maven)
API contract	contracts/openapi.yaml (this repository)

# run the server from a released binary (in-memory store; add -pg-dsn for PostgreSQL)
./gnosivela-linux-amd64 -addr :8080

# or via container image
docker run --rm -p 8080:8080 ghcr.io/axisrobo/GNOSIVELA:1.0.0

DSL compiler (SDK type generation)

Domain types are generated by the DSL compiler from the core repository (a dependency-free, Apache-clean standalone DTO):

# Generate Go types + JSON Schema from a Semantic Contract DSL document
cd ../GNOSIVELA/backend
go run ./cmd/gnosivela-gen -in ../../GNOSIVELA/contracts/examples/supplier.dsl -out ../../GNOSIVELA-open/sdk/go/gnosivela/gen -package gen

# Python + TypeScript DTOs (dataclasses / interfaces)
go run ./cmd/gnosivela-gen -in ../../GNOSIVELA/contracts/examples/supplier.dsl -out ../../GNOSIVELA-open/sdk/python/gnosivela -lang python
go run ./cmd/gnosivela-gen -in ../../GNOSIVELA/contracts/examples/supplier.dsl -out ../../GNOSIVELA-open/sdk/typescript/src -lang typescript

Reference generated types live at sdk/go/gnosivela/gen/ (Go + JSON Schema), sdk/python/gnosivela/gen_supplier.py and sdk/typescript/src/gen_supplier.ts.

The generated gen.Supplier and similar types map one-to-one to core semantic objects for strongly typed client-side modeling.

Quick start

# 1) Start the core service (AGPL core repo; module lives in backend/)
cd ../GNOSIVELA/backend && go run ./cmd/gnosivela

# 2) Run the Go SDK example
go run ./examples/quickstart

Using the SDK

import gnosivela "github.com/axisrobo/GNOSIVELA-open/sdk/go/gnosivela"

c := gnosivela.New("http://localhost:8080")

res, err := c.OntologyCreate(ctx, dslDoc)      // create ontology from DSL
matches, err := c.EntityResolve(ctx, "ACME")   // resolve an entity
a, err := c.AssertionPropose(ctx, assertion)   // propose a knowledge claim

API contract

See contracts/openapi.yaml for the full contract (bound to semantic objects, not to any graph/vector/search vendor).

License

Apache-2.0. See LICENSE.