Metadata-Version: 2.4
Name: computingvista-qservice
Version: 0.1.0
Summary: Official Python SDK for Computing Vista's quantum cloud service (OpenQASM job execution)
License: MIT
Project-URL: Homepage, https://computingvista.com
Project-URL: Repository, https://github.com/thinhqdinh/computingvista-qservice
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# computingvista-qservice

Python SDK chính thức của [Computing Vista](https://computingvista.com) — submit OpenQASM từ Jupyter/VS Code local, chạy trên Computing Vista Cloud.

## Cài đặt

Chưa publish PyPI. Cài trực tiếp từ repo:

```bash
pip install "git+https://github.com/thinhqdinh/computingvista-qservice"
```

Hoặc từ local clone:

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

## Sử dụng

Lấy API key tại `computingvista.com/dashboard/developer`.

```python
from computingvista_qservice import QuantumClient

qc = QuantumClient(token="qkey_live_...")  # hoặc set env QUANTUM_SERVICE_TOKEN

print(qc.get_usage())
# {'used_shots': 2000, 'max_shots': 100000, 'remaining_shots': 98000}

result = qc.run_qasm("""
OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];
cx q[0],q[1];
measure q -> c;
""", shots=1000)

print(result["counts"])
```

`run_qasm` raise `QuotaExceededError` khi vượt hạn mức trial, `QuantumServiceError` cho lỗi khác.
