Skip to main content
BelizeChain Docs
GitHub

Quickstart

Get from a fresh clone to a stored quantum job result in a few minutes.

Install

git clone https://github.com/BelizeChain/kinich-quantum.git
cd kinich-quantum
pip install -r requirements.txt

Run a Simulation

The local simulator backend requires no credentials — ideal for development:

from kinich.backends import get_backend

backend = get_backend("local_simulator")
job = backend.run(circuit, shots=1024)
print(job.counts())

Dispatch to a Cloud Provider

Cloud backends read credentials from environment variables:

export AZURE_QUANTUM_SUBSCRIPTION_ID=...
export AZURE_QUANTUM_RESOURCE_GROUP=...
export AZURE_QUANTUM_WORKSPACE=...

from kinich.backends import get_backend

backend = get_backend("azure_ionq")
job = backend.run(circuit, shots=1024)
result = backend.result(job.id)

Store Results on Pakit

Quantum results can be content-addressed and anchored through Pakit:

from kinich.storage import QuantumResultsStore

store = QuantumResultsStore(pakit_api_url=os.environ["PAKIT_API_URL"])

cid, proof = store.store_quantum_result(
    job_id="my-quantum-job",
    circuit_qasm=circuit,
    counts={"00": 512, "11": 512},
    backend="azure_ionq",
)

print(f"Stored at CID: {cid}")

Large payloads are chunked automatically (256 KB pieces) and reassembled on retrieval.

REST API

The service exposes a FastAPI interface for programmatic access:

curl http://localhost:8888/health

On Ceiba: https://testnet.belizechain.org/api/kinich/health (availability per Testnet).

Next Steps