.. image:: https://badge.fury.io/py/dwave-cloud-client.svg
:target: https://badge.fury.io/py/dwave-cloud-client
:alt: Latest version on PyPI
.. image:: https://circleci.com/gh/dwavesystems/dwave-cloud-client.svg?style=shield
:target: https://circleci.com/gh/dwavesystems/dwave-cloud-client
:alt: Linux/MacOS/Windows build status
.. image:: https://codecov.io/gh/dwavesystems/dwave-cloud-client/branch/master/graph/badge.svg
:target: https://codecov.io/gh/dwavesystems/dwave-cloud-client
:alt: Coverage report
.. index-start-marker
==================
dwave-cloud-client
==================
.. start_cloud_about
D-Wave Cloud Client is a minimal implementation of the REST interface used to
communicate with D-Wave Sampler API (SAPI) servers.
SAPI is an application layer built to provide resource discovery, permissions,
and scheduling for quantum annealing resources at D-Wave Systems.
This package provides a minimal Python interface to that layer without
compromising the quality of interactions and workflow.
The example below instantiates a D-Wave Cloud Client and solver based on the
local system's auto-detected default configuration file and samples a random
Ising problem tailored to fit the solver's graph.
.. code-block:: python
import random
from dwave.cloud import Client
# Connect using the default or environment connection information
with Client.from_config() as client:
# Load the default solver
solver = client.get_solver()
# Build a random Ising model to exactly fit the graph the solver supports
linear = {index: random.choice([-1, 1]) for index in solver.nodes}
quad = {key: random.choice([-1, 1]) for key in solver.undirected_edges}
# Send the problem for sampling, include solver-specific parameter 'num_reads'
computation = solver.sample_ising(linear, quad, num_reads=100)
# Print the first sample out of a hundred
print(computation.samples[0])
.. end_cloud_about
Installation
============
Requires Python 3.8+:
.. code-block:: bash
pip install dwave-cloud-client
To install from source (available on GitHub in
`dwavesystems/dwave-cloud-client`_ repo):
.. code-block:: bash
pip install -r requirements.txt
python setup.py install
.. _`dwavesystems/dwave-cloud-client`: https://github.com/dwavesystems/dwave-cloud-client
License
=======
Released under the Apache License 2.0. See `<LICENSE>`_ file.
Contributing
============
Ocean's `contributing guide <https://docs.dwavequantum.com/en/latest/ocean/contribute.html>`_
has guidelines for contributing to Ocean packages.
Release Notes
-------------
D-Wave Cloud Client uses `reno <https://docs.openstack.org/reno/>`_ to manage
its release notes.
When making a contribution to D-Wave Cloud Client that will affect users, create
a new release note file by running
.. code-block:: bash
reno new your-short-descriptor-here
You can then edit the file created under ``releasenotes/notes/``.
Remove any sections not relevant to your changes.
Commit the file along with your changes.
See reno's `user guide <https://docs.openstack.org/reno/latest/user/usage.html>`_
for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/dwavesystems/dwave-cloud-client",
"name": "dwave-cloud-client",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "D-Wave Systems Inc.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/4e/d7/46bbb96a00167d8da526e80fa1c9324546eeb093dc5aef5b17d005cca2e5/dwave_cloud_client-0.14.3.tar.gz",
"platform": null,
"description": ".. image:: https://badge.fury.io/py/dwave-cloud-client.svg\n :target: https://badge.fury.io/py/dwave-cloud-client\n :alt: Latest version on PyPI\n\n.. image:: https://circleci.com/gh/dwavesystems/dwave-cloud-client.svg?style=shield\n :target: https://circleci.com/gh/dwavesystems/dwave-cloud-client\n :alt: Linux/MacOS/Windows build status\n\n.. image:: https://codecov.io/gh/dwavesystems/dwave-cloud-client/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/dwavesystems/dwave-cloud-client\n :alt: Coverage report\n\n.. index-start-marker\n\n==================\ndwave-cloud-client\n==================\n\n.. start_cloud_about\n\nD-Wave Cloud Client is a minimal implementation of the REST interface used to\ncommunicate with D-Wave Sampler API (SAPI) servers.\n\nSAPI is an application layer built to provide resource discovery, permissions,\nand scheduling for quantum annealing resources at D-Wave Systems.\nThis package provides a minimal Python interface to that layer without\ncompromising the quality of interactions and workflow.\n\nThe example below instantiates a D-Wave Cloud Client and solver based on the\nlocal system's auto-detected default configuration file and samples a random\nIsing problem tailored to fit the solver's graph.\n\n.. code-block:: python\n\n import random\n from dwave.cloud import Client\n\n # Connect using the default or environment connection information\n with Client.from_config() as client:\n\n # Load the default solver\n solver = client.get_solver()\n\n # Build a random Ising model to exactly fit the graph the solver supports\n linear = {index: random.choice([-1, 1]) for index in solver.nodes}\n quad = {key: random.choice([-1, 1]) for key in solver.undirected_edges}\n\n # Send the problem for sampling, include solver-specific parameter 'num_reads'\n computation = solver.sample_ising(linear, quad, num_reads=100)\n\n # Print the first sample out of a hundred\n print(computation.samples[0])\n\n.. end_cloud_about\n\n\nInstallation\n============\n\nRequires Python 3.8+:\n\n.. code-block:: bash\n\n pip install dwave-cloud-client\n\nTo install from source (available on GitHub in\n`dwavesystems/dwave-cloud-client`_ repo):\n\n.. code-block:: bash\n\n pip install -r requirements.txt\n python setup.py install\n\n.. _`dwavesystems/dwave-cloud-client`: https://github.com/dwavesystems/dwave-cloud-client\n\n\nLicense\n=======\n\nReleased under the Apache License 2.0. See `<LICENSE>`_ file.\n\n\nContributing\n============\n\nOcean's `contributing guide <https://docs.dwavequantum.com/en/latest/ocean/contribute.html>`_\nhas guidelines for contributing to Ocean packages.\n\nRelease Notes\n-------------\n\nD-Wave Cloud Client uses `reno <https://docs.openstack.org/reno/>`_ to manage\nits release notes.\n\nWhen making a contribution to D-Wave Cloud Client that will affect users, create\na new release note file by running\n\n.. code-block:: bash\n\n reno new your-short-descriptor-here\n\nYou can then edit the file created under ``releasenotes/notes/``.\nRemove any sections not relevant to your changes.\nCommit the file along with your changes.\n\nSee reno's `user guide <https://docs.openstack.org/reno/latest/user/usage.html>`_\nfor details.\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "A minimal client for interacting with D-Wave cloud resources.",
"version": "0.14.3",
"project_urls": {
"Homepage": "https://github.com/dwavesystems/dwave-cloud-client"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3ac98597b0c5cf652a504da55486e519a8f01700f9e24c998d89687b7db301df",
"md5": "56c1ea4527a2c45857c99736efc0ca03",
"sha256": "aa47bfcda8c1158825aba970ccb1f0b5efec3bde2065aa60d9be6a191d6a4c00"
},
"downloads": -1,
"filename": "dwave_cloud_client-0.14.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "56c1ea4527a2c45857c99736efc0ca03",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 167463,
"upload_time": "2025-11-05T04:29:48",
"upload_time_iso_8601": "2025-11-05T04:29:48.933405Z",
"url": "https://files.pythonhosted.org/packages/3a/c9/8597b0c5cf652a504da55486e519a8f01700f9e24c998d89687b7db301df/dwave_cloud_client-0.14.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4ed746bbb96a00167d8da526e80fa1c9324546eeb093dc5aef5b17d005cca2e5",
"md5": "abf401927dc655de067ae7c4470eaea8",
"sha256": "ec7b0136c7aa7ae2a4416a01e6d83cd52fb9371fb9fc2c1f28c004ad083cb05e"
},
"downloads": -1,
"filename": "dwave_cloud_client-0.14.3.tar.gz",
"has_sig": false,
"md5_digest": "abf401927dc655de067ae7c4470eaea8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 202409,
"upload_time": "2025-11-05T04:29:50",
"upload_time_iso_8601": "2025-11-05T04:29:50.987891Z",
"url": "https://files.pythonhosted.org/packages/4e/d7/46bbb96a00167d8da526e80fa1c9324546eeb093dc5aef5b17d005cca2e5/dwave_cloud_client-0.14.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-05 04:29:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dwavesystems",
"github_project": "dwave-cloud-client",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"circle": true,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.25"
],
[
"<",
"3"
]
]
},
{
"name": "urllib3",
"specs": [
[
">=",
"1.26.0"
],
[
"<",
"3"
]
]
},
{
"name": "pydantic",
"specs": [
[
"<",
"3"
],
[
">=",
"2"
]
]
},
{
"name": "homebase",
"specs": [
[
">=",
"1.0.0"
],
[
"<",
"2"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
">=",
"2.7"
],
[
"<",
"3"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.2"
],
[
"<",
"9"
]
]
},
{
"name": "plucky",
"specs": [
[
"<",
"0.5"
],
[
">=",
"0.4.3"
]
]
},
{
"name": "diskcache",
"specs": [
[
"<",
"6"
],
[
">=",
"5.2.1"
]
]
},
{
"name": "packaging",
"specs": [
[
">=",
"19"
]
]
},
{
"name": "werkzeug",
"specs": [
[
">=",
"3.1.0"
],
[
"<",
"4"
]
]
},
{
"name": "typing-extensions",
"specs": [
[
"<",
"5"
],
[
">=",
"4.5.0"
]
]
},
{
"name": "authlib",
"specs": [
[
">=",
"1.2"
],
[
"<",
"2"
]
]
},
{
"name": "orjson",
"specs": [
[
">=",
"3.11"
]
]
},
{
"name": "http-sf",
"specs": [
[
">=",
"1.0.4"
]
]
},
{
"name": "importlib_metadata",
"specs": [
[
">=",
"5.0.0"
]
]
},
{
"name": "dimod",
"specs": [
[
">=",
"0.10.5"
],
[
"!=",
"0.11.4"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.17.3"
]
]
},
{
"name": "dwave-optimization",
"specs": [
[
">=",
"0.1.0"
]
]
},
{
"name": "dwave-networkx",
"specs": [
[
">=",
"0.8.10"
]
]
},
{
"name": "reno",
"specs": [
[
"~=",
"4.0"
]
]
}
],
"lcname": "dwave-cloud-client"
}
JSON
