Metadata-Version: 2.4
Name: qdsv-runtime
Version: 0.1.0a1
Summary: QDSV Runtime Alpha: a lightweight execution layer for problem-first QDSV workflows.
Project-URL: Homepage, https://qdsv.cloud/
Project-URL: Source, https://github.com/qdsvquantum-afk/qdsv-runtime
Project-URL: QIntent, https://qdsvquantum-afk.github.io/qintent/
Project-URL: Bridge, https://qdsvquantum-afk.github.io/qdsv-bridge/
Project-URL: Qruba, https://qdsvquantum-afk.github.io/qruba/
Author: QDSV / Qruba
License-Expression: MIT
License-File: LICENSE
Keywords: bridge,qdsv,qintent,quantum-software,runtime,semantic-workflows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: qdsv-bridge>=0.1.6
Requires-Dist: qdsv-qintent>=0.1.11
Description-Content-Type: text/markdown

# QDSV Runtime Alpha

[![Status](https://img.shields.io/badge/status-alpha-f59e0b.svg)](#public-alpha-scope)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

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

It ties together the public QDSV developer stack:

```text
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:

```bash
pip install -e .
```

When published:

```bash
pip install qdsv-runtime
```

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

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

## CLI Quickstart

Create a workspace:

```bash
qdsv init
```

Validate a QIntent file:

```bash
qdsv validate examples/basic.qintent
```

Build a Bridge artifact from a supported Bridge spec:

```bash
qdsv build examples/bridge_spec.json --target bridge
```

Generate a local runtime report:

```bash
qdsv report
```

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

```bash
docker exec qruba-api-private qdsv --help
```

## Python SDK

```python
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.
