qdsv-runtime 0.1.0a1

QDSV Runtime Alpha: a lightweight execution layer for problem-first QDSV workflows.

QDSV Runtime Alpha

QDSV Runtime Alpha is a lightweight execution layer for problem-first QDSV workflows.

It ties together the public QDSV developer stack:

QIntent -> QDSV Runtime Alpha -> QDSV Bridge -> OpenQASM / Qiskit / reports

Qruba -> visual human interaction layer
QDSV -> semantic model and private engine

Runtime Alpha does not embed or expose the private QDSV semantic engine. It provides a small workspace, CLI and SDK that call the public QIntent and Bridge clients, save artifacts, and generate reproducibility reports.

Install

For local development:

pip install -e .

When published:

pip install qdsv-runtime

Before the PyPI release, users can install from GitHub after the public repository is created:

pip install git+https://github.com/qdsvquantum-afk/qdsv-runtime.git

CLI Quickstart

Create a workspace:

qdsv init

Validate a QIntent file:

qdsv validate examples/basic.qintent

Build a Bridge artifact from a supported Bridge spec:

qdsv build examples/bridge_spec.json --target bridge

Generate a local runtime report:

qdsv report

Docker/private demo images can also include the same CLI:

docker exec qruba-api-private qdsv --help

Python SDK

from qdsv_runtime import QDSVRuntime

runtime = QDSVRuntime()
runtime.init_workspace()
runtime.validate_intent("examples/basic.qintent")
runtime.build_bridge("examples/bridge_spec.json")
runtime.write_report()

Public Alpha Scope

This alpha includes:

• workspace creation;
• QIntent validation/explain calls through the public API or configured local/private node;
• Bridge build calls for supported public Bridge specifications;
• local artifact storage;
• reproducibility report generation;
• CLI commands for small examples.

This alpha does not include:

• private QDSV Runtime internals;
• semantic compiler internals;
• lowering logic;
• backend selection internals;
• private scoring formulas;
• production scheduler;
• user/tenant management;
• marketplace/plugins;
• local execution of the private semantic engine.

Positioning

QDSV Runtime Alpha is not a quantum operating system. It is an early semantic execution layer for problem-first QDSV workflows. The goal is to show how QIntent, Bridge and future visual environments such as Qruba can be tied together through a small executable layer without exposing the private engine.