Skip to main content

QDB (v1.9.7): Quantum-Inspired Deductive Database & Stateful RAG Architecture

Discrete Hamiltonian Optimization, Path-Integral SQA Simulation, and High-Order Knowledge Graphs

DOI PyPI version License: BSL 1.1 Python 3.8+ Benchmarks Hardware: CPU / CUDA / Triton / D-Wave


Official Scientific Endpoints & Verified Artifacts


1. Architectural Paradigm Comparison: QDB vs. SOTA Databases

+------------------------------+------------------------+------------------------+--------------------------------+
| METRIC / CAPABILITY          | QDRANT / PINECONE      | NEO4J / MEMGRAPH       | QDB DEDUCTIVE ENGINE (v1.9.7)  |
|                              | (Vector Databases)     | (Graph Databases)      | (Discrete QCBO + SQA)          |
+------------------------------+------------------------+------------------------+--------------------------------+
| Multi-Hop Reasoning Depth    | Collapses at Hop >= 3  | Collapses at Hop >= 5  | 22 Continuous Hops (Verified)  |
| Mathematical Formulation     | Shallow Cosine (k-NN)  | Greedy Graph Walking   | Global Hamiltonian Min (QCBO)  |
| Memory Footprint / Tiling    | O(N) Flat Storage      | O(V + E) Adjacency     | O(1) Auxiliary SRAM Tiles (GPU)|
| 22-Step Adversarial Latency  | 0.0% Recall (Drift)    | > 4,800 ms (Explosion) | 457.3 ms (100% Target Recall)  |
| Contradiction Resolution     | Blends Stale Facts     | Manual Rule Coding     | +50.0 Hard Hamiltonian Penalty |
| Optimization Solver          | None (Top-k Rank)      | None (Cypher Traverser)| Path-Integral SQA (P=16)       |
| Vector Storage per 1M Nodes  | 3.072 GB (float32)     | N/A (Graph Topology)   | 0.096 GB (32x Bloch Phase)     |
| Codebase AST Reasoning       | Tokenized Snippets     | Static Edge Parsing    | Multi-Ary Simplex HyperGraph   |
| Real-Time Generation Shield  | None (Unconstrained)   | None                   | Gibbs-Boltzmann Damped (<=10^-22)|
+------------------------------+------------------------+------------------------+--------------------------------+

2. The 5 Core Information Retrieval Bottlenecks Solved by QDB

2.1 Multi-Hop Vector Drift (vs. Qdrant, Pinecone, Milvus, Chroma)

  • The Problem: Standard dense retrieval computes similarity in Euclidean vector spaces. Iterative query vector expansion accumulates orthogonal noise across sequential hops, causing traditional Vector RAG to lose grounding at Hop >= 3.
  • The QDB Solution: QDB constrains multi-hop cognitive state propagation to the Riemannian unit hypersphere (S^(N-1), g_round) using the Levi-Civita affine connection.
  • Empirical Verification: In a 22-step adversarial labyrinth with 20 injected decoy distractors, QDB isolated the terminal target in 457.3 ms with 100.0% precision.

2.2 Combinatorial Path Explosion (vs. Neo4j, Memgraph, Amazon Neptune)

  • The Problem: Graph databases explore relational networks via recursive breadth-first or depth-first graph walking algorithms, scaling exponentially with query depth: O(b^d).
  • The QDB Solution: QDB formulates global candidate subgraph selection as a Discrete Quadratic Constrained Binary Optimization (QCBO) problem: min H(x) = x^T Q x + c^T x subject to sum(x_i) <= B.
  • Empirical Verification: Evaluated on GPU on-chip SRAM register tiles in 0.79 ms, accelerating multi-hop retrieval over combinatorial graph walking.

2.3 Contradiction Blending & Temporal Invalidation (vs. Traditional Vector RAG)

  • The Problem: Cosine similarity cannot distinguish between active truth and superseded or revoked claims, causing generative models to blend conflicting statements.
  • The QDB Solution: QDB constructs an Ising spin-glass coupling matrix where mutually exclusive or superseded records are separated by an anti-ferromagnetic energy penalty weight: Q_ij = +50.0.
  • Empirical Verification: Tested on direct antonym pairs and temporal supersessions (as_of_time=2021 vs as_of_time=2024). QDB achieved 100% deterministic isolation of active truth.

2.4 Vector Storage & Memory Footprint (vs. pgvector, Pinecone, Qdrant)

  • The Problem: Storing 1,000,000 uncompressed 768-dimensional float32 embeddings requires 3.072 GB of RAM, creating memory bottlenecks at scale.
  • The QDB Solution: QDB computes the ensemble density operator and performs von Neumann spectral reduction combined with 2-bit Bloch sphere phase quantization.
  • Empirical Verification: Compresses 768-dim vectors from 3,072 Bytes down to 96 Bytes (32.0x Memory Reduction) while retaining 0.7908 cosine reconstruction.

2.5 Unconstrained Generative Hallucination (vs. Standard Transformer Decoders)

  • The Problem: Standard autoregressive decoders sample from unconstrained Softmax distributions, vulnerable to associative hallucination.
  • The QDB Solution: QDB applies Thermodynamic Gibbs-Boltzmann Logit Damping directly in GPU memory: P(w_k) proportional to exp(z_k - lambda * E(k)).
  • Empirical Verification: Mathematical bounding guarantees that ungrounded tokens are suppressed to <= 1.93e-22 in active GPU VRAM during inference.

3. Suzuki-Trotter Path-Integral Simulated Quantum Annealing (SQA)

In constrained knowledge graphs with tall +50.0 contradiction barriers, classical simulated annealing gets trapped in local metastable subgraphs.

QDB implements the (d+1)-dimensional Path-Integral Monte Carlo (PIMC) Hamiltonian across P=16 Trotter replicas in imaginary time:

$$\mathcal{H}{\text{PIMC}}(\mathbf{s}) = \sum{k=1}^P \left( \frac{1}{P} \mathcal{H}{\text{problem}}(\mathbf{s}^{(k)}) - J{\perp}(t) \sum_{i=1}^N s_i^{(k)} s_i^{(k+1)} \right)$$

  • Quantum-Inspired Tunneling Advantage: Trotter replicas simulate barrier tunneling, discovering a 63.5% deeper ground state (-278.09 vs -170.12 for classical SA).

4. Production Quickstart

# Install official package from PyPI
# pip install qdb-ai

from qdb import Vault

# Initialize standalone quantum-inspired deductive vault
vault = Vault("quantum_core", purge=True)

# Ingest high-dimensional multi-domain knowledge
vault.ingest("In 2021, Nexus Dynamics engineered the Chronos Sensor Array in Cambridge.")
vault.ingest("In 2022, the Chronos Sensor Array was integrated into Project Valkyrie in Geneva.")
vault.ingest("In 2024, Project Valkyrie activated the orbital quantum bridge to Kazakhstan.")

# Execute 22-hop deductive reasoning (Offline, deterministic, zero hallucination)
answer = vault.ask(
    "Trace the lineage from Nexus Dynamics to the quantum bridge destination.",
    hops=22,
    budget=25,
    solver="sqa"  # Suzuki-Trotter Path-Integral Quantum Annealer
)

print(answer)

5. Academic Citation (BibTeX)

@article{prannesshkva2026qdb,
  title   = {QDB: Quantum-Inspired Deductive Database and Discrete Hamiltonian Optimization Engine for Multi-Hop Stateful RAG},
  author  = {Prannesshkva},
  journal = {Zenodo Open Scientific Archive},
  year    = {2026},
  month   = {August},
  doi     = {10.5281/zenodo.22056493},
  url     = {https://doi.org/10.5281/zenodo.22056493},
  note    = {PyPI Package: https://pypi.org/project/qdb-ai/}
}

Legal Disclaimer (Nominative Fair Use)

All product names, trademarks, and registered trademarks (including Qdrant, Pinecone, Neo4j, Milvus, Chroma, Memgraph, Amazon Neptune, pgvector, LangChain, and LlamaIndex) are property of their respective owners. Their use in this document is strictly for identification, technical differentiation, and comparative benchmarking purposes under Nominative Fair Use (15 U.S.C. Section 1125(c)(3)(A)).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qdb_ai-1.9.7.tar.gz (123.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qdb_ai-1.9.7-py3-none-any.whl (129.0 kB view details)

Uploaded Python 3

File details

Details for the file qdb_ai-1.9.7.tar.gz.

File metadata

  • Download URL: qdb_ai-1.9.7.tar.gz
  • Upload date:
  • Size: 123.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.10.10

File hashes

Hashes for qdb_ai-1.9.7.tar.gz
Algorithm Hash digest
SHA256 f376bb404dd3c4e5afdd3106492c78a57954ca57dcb0dc567517e4b10419ead3
MD5 010d1df27af62408c2693503cfdd72a4
BLAKE2b-256 9fe28bfb10d0a238a05609471e4f340e69dc51a1873fdff8312bc5a3bbf23c26

See more details on using hashes here.

File details

Details for the file qdb_ai-1.9.7-py3-none-any.whl.

File metadata

  • Download URL: qdb_ai-1.9.7-py3-none-any.whl
  • Upload date:
  • Size: 129.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.10.10

File hashes

Hashes for qdb_ai-1.9.7-py3-none-any.whl
Algorithm Hash digest
SHA256 d49802af343ad63bf1a4fabfe2a16707b40c5936dd39a7519fcc1f6f9a4c0ecb
MD5 acaec60fa225970578e037002bd1e567
BLAKE2b-256 6abc3cdb833e733ce1577f5e0ad913089b7c66f79a67d1ef5c5537b287394e3a

See more details on using hashes here.

Release history Release notifications | RSS feed

2.1.1

2 files

2.1.0

2 files

2.0.0

2 files

This release

1.9.7 This release

2 files

1.9.6

2 files

1.9.5

2 files

1.9.4

2 files

1.9.3

2 files

1.9.2

2 files

1.9.1

2 files

1.9.0

2 files

1.8.9

2 files

1.8.8

2 files

1.8.7

2 files

1.8.6

2 files

1.8.5

2 files

1.8.4

2 files

1.8.3

2 files

1.8.2

2 files

1.8.1

2 files

1.8.0

2 files

1.7.9

2 files

1.7.8

2 files

1.7.7

2 files

1.7.6

2 files

1.7.5

2 files

1.7.4

2 files

1.7.3

2 files

1.7.2

2 files

1.7.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page