Qinematos Documentation

Welcome to the Qinematos documentation. Qinematos is a Deterministic Data Base Plane designed specifically for AI agent infrastructure, implementing the RVP Framework (Recent, Vulgate, Plain) for zero-copy context delivery.

What is Qinematos?

Qinematos solves the "AI Plumbing Crisis" - the fundamental limitations of current RAG (Retrieval-Augmented Generation) systems that plague modern AI agent deployments:

  • Probabilistic search gives agents fuzzy, unreliable context
  • High latency from JSON serialization (10-100ms per request)
  • No audit trail for regulatory compliance
  • Memory waste from multiple data copies between processes

The RVP Framework

R - Recent

Live gRPC streaming ensures agents receive current data, not stale cached snapshots. The Watch API provides server-streaming subscriptions with reactive Mutiny core.

V - Vulgate

Apache Arrow provides a canonical data format - a "common tongue" for all agents. Whether your agent is written in Python, Java, Rust, or any other language, it reads the same strongly-typed schema.

P - Plain

Zero-copy IPC via Java 25 Foreign Function & Memory API. Data stays where it is - agents receive file path handles and read directly from memory-mapped files at RAM speed.

Getting Started

1

Quick Start

Get Qinematos running in 5 minutes. Clone, build, and make your first API call.
2

Architecture

Understand the three-layer architecture and core components.
3

API Reference

Complete REST, gRPC, and MCP API documentation with examples.

Key Features

Feature Description
Zero-Copy IPC Memory-mapped files using Java 25 FFM API for <5ms latency
Topic-Based Pub/Sub Hierarchical topics with Arrow schema versioning
Full Lineage Content-addressable traces with eBPF kernel-level auditing
MCP Protocol Anthropic Model Context Protocol for standardized agent access
gRPC Watch API Server-streaming subscriptions with reactive core
ACID Persistence JetBrains Xodus embedded transactional storage

Technology Stack

  • Runtime: Quarkus 3.30.2 with GraalVM native support
  • Language: Java 25 with Foreign Function & Memory API
  • Data Format: Apache Arrow 18.0
  • Messaging: gRPC with Mutiny reactive streams
  • Persistence: JetBrains Xodus ACID store
  • Observability: OpenTelemetry + Prometheus metrics

License

Qinematos is open source software licensed under the Apache License 2.0.