QXel SaaS
Build with QXel SaaS.
The hosted QXel service and Python SDK: submit Amazon Braket circuits to managed GPU workers with a single API key, no infrastructure to run.
Get started
Installation
The QXel SaaS Python SDK submits Amazon Braket circuits to the hosted QXel simulator on managed GPU workers, so there is no infrastructure to run. It's distributed as qxel-saas and imported as QXelSaas.
Authentication
Every request authenticates with your tenant API key. Generate one in the dashboard, then expose it to the SDK.
Quickstart
Submit your first circuit to QXel SaaS in a few lines. Circuits are built with the Amazon Braket SDK.
Simulator types
Choose a simulator with the simulator_type argument when you create the client.
Running jobs
Blocking run
run() submits a circuit, waits for it to finish, and returns the result. It is the simplest way to execute a circuit.
Async submit
submit() sends the circuit and returns a job handle right away without blocking. Use it when a job is slow (a cold GPU worker can take a few minutes), when you want to submit several circuits at once, or when you want to do other work while it runs.
Result types
Attach Braket result types to ask QXel for more than measurement counts. The result comes back under result_types, alongside measurement_counts.
Managing jobs
Job status
Every job has a handle (QXelJob) that you can query at any time. Look one up by id with sim.get_job(job_id), then read its status and helper fields.
List jobs
sim.list_jobs() returns the recent jobs for your tenant, newest first, each as a QXelJob handle. Use it to build a dashboard, find a job_id you forgot, or filter for failures.
Cancel a job
Call job.cancel() to stop a job you no longer need. This frees the worker and stops billing for it. cancel() returns the updated handle.
Reference
Job lifecycle
A job moves through a small set of statuses. The SDK reports each transition, and with verbose mode (on by default) it also prints the finer phase within a status.
Result shape
A successful state-vector run returns a JSON object like this.
FAQ
Common questions about running on the QXel SaaS platform.