A Rust-native, modular platform for Semantic Web, SPARQL 1.2, GraphQL, and AI-augmented reasoning

Status: Alpha Release (v0.1.0-alpha.3) - Released October 12, 2025

⚠️ Alpha Software: This is an early alpha release. APIs may change without notice. Suitable for production alpha testing and internal applications.

OxiRS aims to be a Rust-first, JVM-free alternative to Apache Jena + Fuseki and to Juniper, providing:

• Protocol choice, not lock-in: Expose both SPARQL 1.2 and GraphQL endpoints from the same dataset
• Incremental adoption: Each crate works stand-alone; opt into advanced features via Cargo features
• AI readiness: Native integration with vector search, graph embeddings, and LLM-augmented querying
• Single static binary: Match or exceed Jena/Fuseki feature-for-feature while keeping a <50MB footprint

# Install the CLI tool
cargo install oxirs --version 0.1.0-alpha.3

# Or build from source
git clone https://github.com/cool-japan/oxirs.git
cd oxirs
cargo build --workspace --release

• Query Intelligence: oxirs explain introduces PostgreSQL-style plans with analyze/full modes, complexity scoring, and optimization hints for SPARQL workloads.
• Reusable SPARQL Templates: Nine parameterizable templates (basic, federation, analytics, property paths) now ship with the CLI for faster queries.
• Persistent Query History: Automatic tracking, replay, search, and statistics for every CLI query, stored under ~/.local/share/oxirs/query_history.json.
• Industry 4.0 SAMM tooling: Six new generators (GraphQL, TypeScript, Python, Java, Scala, SQL) plus AAS pipelines deliver 16 total codegen targets.
• Enterprise Quality Bar: Workspace-wide -D warnings enforcement, 200+ Clippy fixes, and 4,421 tests ensure a clean alpha-grade release.

# Initialize a new knowledge graph (alphanumeric, _, - only)
oxirs init mykg

# Import RDF data (automatically persisted to mykg/data.nq)
oxirs import mykg data.ttl --format turtle

# Query the data (loaded automatically from disk)
oxirs query mykg "SELECT * WHERE { ?s ?p ?o } LIMIT 10"

# Query with specific patterns
oxirs query mykg "SELECT ?name WHERE { ?person <http://xmlns.com/foaf/0.1/name> ?name }"

# Start the server
oxirs serve mykg/oxirs.toml --port 3030

Features:

• ✅ Persistent storage: Data automatically saved to disk in N-Quads format
• ✅ SPARQL queries: SELECT, ASK, CONSTRUCT, DESCRIBE supported
• ✅ Auto-load: No manual save/load needed
• 🚧 PREFIX support: Coming in next release

Open:

• http://localhost:3030 for the Fuseki-style admin UI
• http://localhost:3030/graphql for GraphiQL (if enabled)

All crates are published to crates.io and documented on docs.rs.

Crate	Version	Docs	Description
oxirs-core			Core RDF and SPARQL functionality

Crate	Version	Docs	Description
oxirs-fuseki			SPARQL 1.1/1.2 HTTP server
oxirs-gql			GraphQL endpoint for RDF

Crate	Version	Docs	Description
oxirs-arq			SPARQL query engine
oxirs-rule			Rule-based reasoning
oxirs-shacl			SHACL validation
oxirs-samm			SAMM metamodel & AAS
oxirs-geosparql			GeoSPARQL support
oxirs-star			RDF-star support
oxirs-ttl			Turtle parser
oxirs-vec			Vector search

Crate	Version	Docs	Description
oxirs-tdb			TDB2-compatible storage
oxirs-cluster			Distributed clustering

Crate	Version	Docs	Description
oxirs-stream			Real-time streaming
oxirs-federate			Federated queries

Crate	Version	Docs	Description
oxirs-embed			Knowledge graph embeddings
oxirs-shacl-ai			AI-powered SHACL
oxirs-chat			RAG chat API

Crate	Version	Docs	Description
oxirs (CLI)			CLI tool

oxirs/                  # Cargo workspace root
├─ core/                # Thin, safe re-export of oxigraph
│  └─ oxirs-core
├─ server/              # Network front ends
│  ├─ oxirs-fuseki      # SPARQL 1.1/1.2 HTTP protocol, Fuseki-compatible config
│  └─ oxirs-gql         # GraphQL façade (Juniper + mapping layer)
├─ engine/              # Query, update, reasoning
│  ├─ oxirs-arq         # Jena-style algebra + extension points
│  ├─ oxirs-rule        # Forward/backward rule engine (RDFS/OWL/SWRL)
│  ├─ oxirs-samm        # SAMM metamodel + AAS integration (Industry 4.0)
│  ├─ oxirs-geosparql   # GeoSPARQL spatial queries and topological relations
│  ├─ oxirs-shacl       # SHACL Core + SHACL-SPARQL validator
│  ├─ oxirs-star        # RDF-star / SPARQL-star grammar support
│  ├─ oxirs-ttl         # Turtle/TriG parser and serializer
│  └─ oxirs-vec         # Vector index abstractions (SciRS2, hnsw_rs)
├─ storage/
│  ├─ oxirs-tdb         # MVCC layer & assembler grammar (TDB2 parity)
│  └─ oxirs-cluster     # Raft-backed distributed dataset
├─ stream/              # Real-time and federation
│  ├─ oxirs-stream      # Kafka/NATS I/O, RDF Patch, SPARQL Update delta
│  └─ oxirs-federate    # SERVICE planner, GraphQL stitching
├─ ai/
│  ├─ oxirs-embed       # KG embeddings (TransE, ComplEx…)
│  ├─ oxirs-shacl-ai    # Shape induction & data repair suggestions
│  └─ oxirs-chat        # RAG chat API (LLM + SPARQL)
└─ tools/
    ├─ oxirs             # CLI (import, export, star-migrate, bench)
    └─ benchmarks/       # SP2Bench, WatDiv, LDBC SGS

Legend:

• ✅ Alpha: Usable with 100+ tests, may have bugs, suitable for alpha testing
• 🔄 Experimental: Under active development, APIs unstable
• ⏳ Planned: Not yet implemented
• 🔸 Partial/plug-in support in Jena

Quality Metrics (v0.1.0-alpha.3):

• 4,421 tests passing (99.98% pass rate)
• Zero compilation warnings (enforced with -D warnings)
• 200+ clippy lints fixed
• 7/7 integration tests passing

[dataset.mykg]
type      = "tdb2"
location  = "/data"
text      = { enabled = true, analyzer = "english" }
shacl     = ["./shapes/person.ttl"]

query {
  Person(where: {familyName: "Yamada"}) {
    givenName
    homepage
    knows(limit: 5) { givenName }
  }
}

SELECT ?s ?score WHERE {
  SERVICE <vec:similar ( "LLM embeddings of 'semantic web'" 0.8 )> {
    ?s ?score .
  }
}

• Rust 1.70+ (MSRV)
• Optional: Docker for containerized deployment

# Clone the repository
git clone https://github.com/cool-japan/oxirs.git
cd oxirs

# Build all crates
cargo build --workspace

# Run tests
cargo nextest run --no-fail-fast

# Run with all features
cargo build --workspace --all-features

Optional features to keep dependencies minimal:

• geo: GeoSPARQL support
• text: Full-text search with Tantivy
• ai: Vector search and embeddings
• cluster: Distributed storage with Raft
• star: RDF-star and SPARQL-star support
• vec: Vector index abstractions

We welcome contributions! Please see our Contributing Guide for details.

• Design documents go in ./rfcs/ with lazy-consensus and 14-day comment window
• All code must pass rustfmt + nightly 2025-06, Clippy --all-targets --workspace -D warnings
• Commit sign-off required (DCO 1.1)

SAMM & AAS Integration:

• ✅ 16 code generators (GraphQL, TypeScript, Python, Java, Scala, SQL, OpenAPI, AsyncAPI, HTML, JSON Schema, Markdown, Rust, AAS, Turtle, Sample, Diagram)
• ✅ 100% Java ESMF SDK command coverage (19/19 commands)
• ✅ AAS to SAMM conversion pipeline (XML/JSON/AASX support)
• ✅ Package management with namespace sharing

Federation & Distribution:

• ✅ oxirs-federate: 100% Beta Release targets achieved in alpha.3
• ✅ Distributed transactions (2PC, Saga pattern, eventual consistency)
• ✅ Multi-provider authentication (OAuth2, SAML, JWT, API keys)
• ✅ OpenTelemetry integration with circuit breakers

Code Quality Excellence:

• ✅ Zero-warning compilation enforced (-D warnings)
• ✅ 200+ clippy lints fixed across 13+ crates
• ✅ 4,421 tests passing (99.98% pass rate, 88.8s execution)
• ✅ SHACL: 100% W3C compliance (27/27 constraints, 344 tests)

Production Features:

• ✅ Performance module (caching, profiling, batch processing)
• ✅ Template engine with custom filters
• ✅ Metrics, health checks, structured logging

GeoSPARQL & Spatial Features:

• ✅ OGC GeoSPARQL 1.1 compliance (183 tests)
• ✅ R-tree spatial indexing with stress tests (50k points)
• ✅ Performance optimization module (parallel, streaming for large datasets)
• ✅ Simple Features, Egenhofer-9, RCC-8 topological relations
• ✅ WKT/GML parsing, CRS transformations (PROJ integration)
• ✅ Comprehensive spatial queries (bbox, within-distance, k-NN)

Beta.1 Features Already Complete in Alpha.3: 🎉

• ✅ Production Hardening - oxirs-core, oxirs-arq, oxirs-fuseki
  • Circuit breakers for fault tolerance
  • Performance monitoring with latency statistics
  • Resource quotas and rate limiting
  • Health checks for all components
  • Comprehensive benchmarking suites (17 benchmark groups total)
  • Stress testing suites (20 comprehensive tests total)

Remaining Focus Areas:

• 🎯 API stability and versioning guarantees
• 🎯 Production performance benchmarking (validate 10x claims)
• 🎯 Security audit and hardening
• 🎯 Comprehensive documentation (95%+ coverage)
• 🎯 Test coverage increase to 95%+
• 🎯 Migration guides and examples
• 🎯 Performance SLAs and optimization

OxiRS is dual-licensed under either:

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.

See LICENSE for details.

• Issues & RFCs: https://github.com/cool-japan/oxirs
• Maintainer: @cool-japan (KitaSan)

📄 Full notes live in CHANGELOG.md.

• 🏭 SAMM & AAS Integration: Industry 4.0 digital twin support with SAMM (Semantic Aspect Meta Model) 2.0.0-2.3.0 parser and bidirectional AAS (Asset Administration Shell) conversion
• 🎨 16 Code Generators: GraphQL, TypeScript, Python, Java, Scala, Rust, SQL, OpenAPI, AsyncAPI, HTML, JSON Schema, Markdown, and more
• 🔄 Java ESMF SDK Compatible: Drop-in replacement syntax (samm → oxirs) for seamless migration from Java tooling
• ⚙️ Persistent RDF pipeline: Automatic on-disk save/load in N-Quads, streaming import/export/migrate flows, and configurable parallel batch ingestion
• 🧠 Interactive SPARQL tooling: Full-featured CLI REPL with history search, templates, syntax hints, SELECT */wildcard fixes, and multi-line editing
• 🌐 Federated querying: SPARQL 1.1 SERVICE support with retries, SERVICE SILENT, JSON results merging, and verified interoperability with DBpedia/Wikidata
• 🔐 Production safeguards: OAuth2/OIDC + JWT, seven security headers, HSTS, structured logging, and Prometheus metrics with slow-query tracing
• 🚀 Performance improvements: SIMD-accelerated SciRS2 operators, streaming pipelines, and 4,421+ tests (including 7 integration suites) covering the new workflow
• ✨ Code quality: Zero-warning compilation enforced with -D warnings across all 21 crates - 200+ clippy lints fixed

• Large dataset (>100M triples) performance optimization continues; benchmark feedback appreciated
• AI-centric crates (oxirs-chat, oxirs-embed, oxirs-shacl-ai) remain experimental
• Advanced serialization documentation being expanded

• ✅ Zero warnings - Strict -D warnings enforced across all 21 crates
• ✅ 4,421 tests passing - 99.98% pass rate (88.8s execution time)
• ✅ 200+ clippy lints fixed - Comprehensive code quality improvements
• ✅ 7/7 integration tests passing - Complete RDF pipeline validated

• Install the new CLI with cargo install oxirs --version 0.1.0-alpha.3 or update individual crates via Cargo.toml
• Breaking change: CLI syntax updated to match Java ESMF SDK - replace oxirs samm with oxirs aspect (see CHANGELOG.md for migration guide)
• New oxirs aas command for AAS integration (XML/JSON/AASX support)
• Existing dataset directories from alpha.1/alpha.2 remain compatible; the new persistence layer will automatically detect and upgrade saved N-Quads data
• Outbound HTTP access is required for federation; configure firewall rules and timeouts before enabling cross-endpoint queries

"Rust makes memory safety table stakes; Oxirs makes knowledge-graph engineering table stakes."

Third alpha release - October 12, 2025