---
id: dwave-cloud-client
version: "0.14.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# dwave-cloud-client — A minimal client for interacting with D-Wave cloud resources.

License: permissive · Maintenance: active · Downloads: 102.0K/mo

## What it is and what it does

D-Wave Cloud Client is a minimal REST client for communicating with D-Wave's SAPI quantum annealing service. It abstracts the HTTP layer and provides a Pythonic interface to discover available solvers, submit quantum optimization problems (Ising and QUBO models), and retrieve results. The package handles authentication, connection pooling via requests and urllib3, and response parsing with orjson.

You use it by instantiating a Client (typically from a local config file or environment), selecting a solver based on your problem's graph structure, and calling sample methods with your problem definition and solver parameters. The package is designed for workflows where you have a quantum optimization problem that fits D-Wave's hardware topology and you want to run it on their cloud infrastructure without managing HTTP details yourself.

Use it for:

- Submit Ising or QUBO optimization problems to D-Wave quantum annealers from a Python application.
- Discover available solvers and their properties (graph topology, supported parameters) before formulating a problem.
- Integrate quantum annealing into a hybrid classical-quantum workflow where you preprocess data locally and offload optimization to the cloud.
- Batch-submit multiple problem instances to the same solver with different parameters and collect results asynchronously.
- Prototype quantum algorithms and test problem formulations against real quantum hardware without managing cloud infrastructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

D-Wave Cloud Client provides a Python interface to D-Wave's SAPI quantum annealing service, enabling you to submit Ising and QUBO problems to remote quantum annealers and retrieve solutions.

Yes, if you have D-Wave cloud access and need to run quantum annealing workloads from Python. The package is actively maintained, has low install friction, and provides a clean abstraction over SAPI. The Apache 2.0 license poses no restrictions. Install only if you have valid D-Wave credentials and a concrete quantum optimization problem; it is not useful as a general-purpose library.

## Install

pip install dwave-cloud-client
uv add dwave-cloud-client
poetry add dwave-cloud-client

## Installing dwave-cloud-client

Before you install: Low friction installation with a pure-Python wheel. Active maintenance with a recent release (14 days old) and modern Python support (3.10–3.14). Moderate dependency footprint (15 runtime packages) but all are standard, well-maintained libraries.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and note any modifications, but no copyleft obligations apply.

Quickstart:

pip install dwave-cloud-client

from dwave.cloud import Client

with Client.from_config() as client:
    solver = client.get_solver()
    result = solver.sample_ising({0: -1}, {(0, 1): 1}, num_reads=100)

Requires Python 3.10 or later; also requires valid D-Wave cloud credentials configured locally or via environment variables to connect to SAPI.

Verify before relying:

- Whether the package supports offline problem formulation or requires active cloud connectivity for all operations.
- Performance characteristics and latency expectations for typical problem sizes and submission patterns.
- Whether the package includes built-in retry logic or timeout handling for network failures.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 102.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

quantum annealing client, D-Wave SAPI interface, quantum sampler REST API, quantum problem submission, D-Wave cloud connection, quantum computing client library, Ising problem solver, quantum-computing, optimization, cloud-api

[View on SkillFed](https://skillfed.io/packages/dwave-cloud-client) · [View on PyPI](https://pypi.org/project/dwave-cloud-client/)