Skip to main content

QDB (v1.9.6): 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.6)  |
|                              | (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.6.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.6-py3-none-any.whl (129.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qdb_ai-1.9.6.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.6.tar.gz
Algorithm Hash digest
SHA256 795b316af1e68de536243d38fe21f8ec9b3052f2a2623ef4d6d83daaf8a77798
MD5 189f9d7bb5624559ab7e95a5a3d5fd43
BLAKE2b-256 4a78838b2e2bd36d00ec6f929d29895efa63bc6c427bb4f3300725e329a7da66

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qdb_ai-1.9.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b1b125e3ad5c39fc72f6d9f823bf4990a51bf1504c325cbea7c74f1d45290d7b
MD5 69ca31cea6733d349f28780dc985679b
BLAKE2b-256 2ab37648fc75477f7e54566b8b34c0fb14dcb662cf756759951e59fb0a535dd3

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

1.9.7

2 files

This release

1.9.6 This release

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