Get started

Quickstart

Submit your first circuit to QXel SaaS in a few lines. Circuits are built with the Amazon Braket SDK.

1. Install and authenticate

bash
pip install qxel-saas
export QXEL_SAAS_API_KEY="qxel_saas_..."

2. Build a circuit

Use the Braket SDK to build a Bell state (two entangled qubits):

python
from braket.circuits import Circuit

circuit = Circuit().h(0).cnot(0, 1)

3. Run it

Create a client and call run(). It blocks until the job finishes on a managed worker and returns the result.

python
import os
from QXelSaas import QXel

sim = QXel(api_key=os.environ["QXEL_SAAS_API_KEY"])
result = sim.run(circuit, shots=256)
print(result)

Output

{'result_type': 'qxel_state_vector', 'simulator': 'QXel-sv',
 'shots': 256, 'measurement_counts': {'00': 128, '11': 128}}

The near-even split between '00' and '11' confirms an entangled Bell state. Counts vary because the result is sampled.

← AuthenticationSimulator types →