qiskit-ibm-provider


Nameqiskit-ibm-provider JSON
Version 0.11.0 PyPI version JSON
download
home_pagehttps://github.com/Qiskit/qiskit-ibm-provider
SummaryQiskit IBM Quantum Provider for accessing the quantum devices and simulators at IBM
upload_time2024-04-17 14:49:07
maintainerNone
docs_urlNone
authorQiskit Development Team
requires_python>=3.8
licenseApache 2.0
keywords qiskit quantum
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Qiskit IBM Quantum Provider (_NOW DEPRECATED_)

[![License](https://img.shields.io/github/license/Qiskit/qiskit-ibm-provider.svg?style=popout-square)](https://opensource.org/licenses/Apache-2.0)
[![CI](https://github.com/Qiskit/qiskit-ibm-provider/actions/workflows/ci.yml/badge.svg)](https://github.com/Qiskit/qiskit-ibm-provider/actions/workflows/ci.yml)
[![](https://img.shields.io/github/release/Qiskit/qiskit-ibm-provider.svg?style=popout-square)](https://github.com/Qiskit/qiskit-ibm-provider/releases)
[![](https://img.shields.io/pypi/dm/qiskit-ibm-provider.svg?style=popout-square)](https://pypi.org/project/qiskit-ibm-provider/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Coverage Status](https://coveralls.io/repos/github/Qiskit/qiskit-ibm-provider/badge.svg?branch=main)](https://coveralls.io/github/Qiskit/qiskit-ibm-provider?branch=main)

---

**_PLEASE NOTE:_** _As of version 0.11.0, released in April 2024, `qiskit-ibm-provider` has been deprecated
with its support ending and eventual archival being no sooner than 3 months from that date. The
function provided by `qiskit-ibm-provider` has been moved to [qiskit-ibm-runtime](https://github.com/Qiskit/qiskit-ibm-runtime).
Please see the [Runtime migration Guide] for more details. We encourage you
to migrate over at your earliest convenience._

---

**Qiskit** is an open-source SDK for working with quantum computers at the level of circuits, algorithms, and application modules.

This project contains a provider that allows accessing the **[IBM Quantum]**
systems and simulators.

## Migrating from qiskit-ibmq-provider

If you are familiar with the `qiskit-ibmq-provider` repository, check out the [migration guide].

## Installation

You can install the provider using pip:

```bash
pip install qiskit-ibm-provider
```

## Provider Setup

1. Create an IBM Quantum account or log in to your existing account by visiting the [IBM Quantum login page].

1. Copy (and/or optionally regenerate) your API token from your
   [IBM Quantum account page].

1. Take your token from step 2, here called `MY_API_TOKEN`, and save it by calling `IBMProvider.save_account()`:

   ```python
   from qiskit_ibm_provider import IBMProvider
   IBMProvider.save_account(token='MY_API_TOKEN')
   ```

   The command above stores your credentials locally in a configuration file called `qiskit-ibm.json`. By default, this file is located in `$HOME/.qiskit`, where `$HOME` is your home directory.
   Once saved you can then instantiate the provider like below and access the backends:

   ```python
   from qiskit_ibm_provider import IBMProvider
   provider = IBMProvider()

   # display current supported backends
   print(provider.backends())

   # get IBM's simulator backend
   simulator_backend = provider.get_backend('ibmq_qasm_simulator')
   ```

### Load Account from Environment Variables
Alternatively, the IBM Provider can discover credentials from environment variables:
```bash
export QISKIT_IBM_TOKEN='MY_API_TOKEN'
```

Then instantiate the provider without any arguments and access the backends:
```python
from qiskit_ibm_provider import IBMProvider
provider = IBMProvider()
```

### Enable Account for Current Session
As another alternative, you can also enable an account just for the current session by instantiating the provider with the token.

```python
from qiskit_ibm_provider import IBMProvider
provider = IBMProvider(token='MY_API_TOKEN')
```

## Next Steps

Now you're set up and ready to check out some of the tutorials.
- [IBM Quantum Learning]
- [Qiskit]

## Contribution Guidelines

If you'd like to contribute to qiskit-ibm-provider, please take a look at our
[contribution guidelines]. This project adheres to Qiskit's [code of conduct].
By participating, you are expect to uphold to this code.

We use [GitHub issues] for tracking requests and bugs. Please use our [slack]
for discussion and simple questions. To join our Slack community, use the
invite link [here](https://docs.quantum.ibm.com/support#qiskit).

## Authors and Citation

The Qiskit IBM Quantum Provider is the work of [many people] who contribute to the
project at different levels. If you use Qiskit, please cite as per the included
[BibTeX file].

## License

[Apache License 2.0].


[IBM Quantum]: https://www.ibm.com/quantum-computing/
[IBM Quantum login page]:  https://quantum-computing.ibm.com/login
[IBM Quantum account page]: https://quantum-computing.ibm.com/account
[contribution guidelines]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/CONTRIBUTING.md
[code of conduct]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/CODE_OF_CONDUCT.md
[GitHub issues]: https://github.com/Qiskit/qiskit-ibm-provider/issues
[slack]: https://qiskit.slack.com
[many people]: https://github.com/Qiskit/qiskit-ibm-provider/graphs/contributors
[IBM Quantum Learning]: https://learning.quantum.ibm.com/catalog/tutorials
[Qiskit]: https://github.com/Qiskit/qiskit-tutorial
[BibTeX file]: https://github.com/Qiskit/qiskit/blob/master/Qiskit.bib
[Apache License 2.0]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/LICENSE.txt
[migration guide]: https://github.com/Qiskit/qiskit-ibm-provider/blob/6be5f3297ede75bb062b20601058b55a397668e3/docs/tutorials/Migration_Guide_from_qiskit-ibmq-provider.ipynb
[Runtime migration guide]: https://docs.quantum.ibm.com/api/migration-guides/qiskit-runtime

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Qiskit/qiskit-ibm-provider",
    "name": "qiskit-ibm-provider",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "qiskit, quantum",
    "author": "Qiskit Development Team",
    "author_email": "qiskit@us.ibm.com",
    "download_url": "https://files.pythonhosted.org/packages/3b/75/a3a940de9adbd2c9b85b12e8401a6cbf9b4b6b41d3b65fde64980eaa865e/qiskit_ibm_provider-0.11.0.tar.gz",
    "platform": null,
    "description": "# Qiskit IBM Quantum Provider (_NOW DEPRECATED_)\n\n[![License](https://img.shields.io/github/license/Qiskit/qiskit-ibm-provider.svg?style=popout-square)](https://opensource.org/licenses/Apache-2.0)\n[![CI](https://github.com/Qiskit/qiskit-ibm-provider/actions/workflows/ci.yml/badge.svg)](https://github.com/Qiskit/qiskit-ibm-provider/actions/workflows/ci.yml)\n[![](https://img.shields.io/github/release/Qiskit/qiskit-ibm-provider.svg?style=popout-square)](https://github.com/Qiskit/qiskit-ibm-provider/releases)\n[![](https://img.shields.io/pypi/dm/qiskit-ibm-provider.svg?style=popout-square)](https://pypi.org/project/qiskit-ibm-provider/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Coverage Status](https://coveralls.io/repos/github/Qiskit/qiskit-ibm-provider/badge.svg?branch=main)](https://coveralls.io/github/Qiskit/qiskit-ibm-provider?branch=main)\n\n---\n\n**_PLEASE NOTE:_** _As of version 0.11.0, released in April 2024, `qiskit-ibm-provider` has been deprecated\nwith its support ending and eventual archival being no sooner than 3 months from that date. The\nfunction provided by `qiskit-ibm-provider` has been moved to [qiskit-ibm-runtime](https://github.com/Qiskit/qiskit-ibm-runtime).\nPlease see the [Runtime migration Guide] for more details. We encourage you\nto migrate over at your earliest convenience._\n\n---\n\n**Qiskit** is an open-source SDK for working with quantum computers at the level of circuits, algorithms, and application modules.\n\nThis project contains a provider that allows accessing the **[IBM Quantum]**\nsystems and simulators.\n\n## Migrating from qiskit-ibmq-provider\n\nIf you are familiar with the `qiskit-ibmq-provider` repository, check out the [migration guide].\n\n## Installation\n\nYou can install the provider using pip:\n\n```bash\npip install qiskit-ibm-provider\n```\n\n## Provider Setup\n\n1. Create an IBM Quantum account or log in to your existing account by visiting the [IBM Quantum login page].\n\n1. Copy (and/or optionally regenerate) your API token from your\n   [IBM Quantum account page].\n\n1. Take your token from step 2, here called `MY_API_TOKEN`, and save it by calling `IBMProvider.save_account()`:\n\n   ```python\n   from qiskit_ibm_provider import IBMProvider\n   IBMProvider.save_account(token='MY_API_TOKEN')\n   ```\n\n   The command above stores your credentials locally in a configuration file called `qiskit-ibm.json`. By default, this file is located in `$HOME/.qiskit`, where `$HOME` is your home directory.\n   Once saved you can then instantiate the provider like below and access the backends:\n\n   ```python\n   from qiskit_ibm_provider import IBMProvider\n   provider = IBMProvider()\n\n   # display current supported backends\n   print(provider.backends())\n\n   # get IBM's simulator backend\n   simulator_backend = provider.get_backend('ibmq_qasm_simulator')\n   ```\n\n### Load Account from Environment Variables\nAlternatively, the IBM Provider can discover credentials from environment variables:\n```bash\nexport QISKIT_IBM_TOKEN='MY_API_TOKEN'\n```\n\nThen instantiate the provider without any arguments and access the backends:\n```python\nfrom qiskit_ibm_provider import IBMProvider\nprovider = IBMProvider()\n```\n\n### Enable Account for Current Session\nAs another alternative, you can also enable an account just for the current session by instantiating the provider with the token.\n\n```python\nfrom qiskit_ibm_provider import IBMProvider\nprovider = IBMProvider(token='MY_API_TOKEN')\n```\n\n## Next Steps\n\nNow you're set up and ready to check out some of the tutorials.\n- [IBM Quantum Learning]\n- [Qiskit]\n\n## Contribution Guidelines\n\nIf you'd like to contribute to qiskit-ibm-provider, please take a look at our\n[contribution guidelines]. This project adheres to Qiskit's [code of conduct].\nBy participating, you are expect to uphold to this code.\n\nWe use [GitHub issues] for tracking requests and bugs. Please use our [slack]\nfor discussion and simple questions. To join our Slack community, use the\ninvite link [here](https://docs.quantum.ibm.com/support#qiskit).\n\n## Authors and Citation\n\nThe Qiskit IBM Quantum Provider is the work of [many people] who contribute to the\nproject at different levels. If you use Qiskit, please cite as per the included\n[BibTeX file].\n\n## License\n\n[Apache License 2.0].\n\n\n[IBM Quantum]: https://www.ibm.com/quantum-computing/\n[IBM Quantum login page]:  https://quantum-computing.ibm.com/login\n[IBM Quantum account page]: https://quantum-computing.ibm.com/account\n[contribution guidelines]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/CONTRIBUTING.md\n[code of conduct]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/CODE_OF_CONDUCT.md\n[GitHub issues]: https://github.com/Qiskit/qiskit-ibm-provider/issues\n[slack]: https://qiskit.slack.com\n[many people]: https://github.com/Qiskit/qiskit-ibm-provider/graphs/contributors\n[IBM Quantum Learning]: https://learning.quantum.ibm.com/catalog/tutorials\n[Qiskit]: https://github.com/Qiskit/qiskit-tutorial\n[BibTeX file]: https://github.com/Qiskit/qiskit/blob/master/Qiskit.bib\n[Apache License 2.0]: https://github.com/Qiskit/qiskit-ibm-provider/blob/main/LICENSE.txt\n[migration guide]: https://github.com/Qiskit/qiskit-ibm-provider/blob/6be5f3297ede75bb062b20601058b55a397668e3/docs/tutorials/Migration_Guide_from_qiskit-ibmq-provider.ipynb\n[Runtime migration guide]: https://docs.quantum.ibm.com/api/migration-guides/qiskit-runtime\n",
    "bugtrack_url": null,
    "license": "Apache 2.0",
    "summary": "Qiskit IBM Quantum Provider for accessing the quantum devices and simulators at IBM",
    "version": "0.11.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/Qiskit/qiskit-ibm-provider/issues",
        "Documentation": "https://docs.quantum.ibm.com/api/qiskit-ibm-provider/",
        "Homepage": "https://github.com/Qiskit/qiskit-ibm-provider",
        "Source Code": "https://github.com/Qiskit/qiskit-ibm-provider"
    },
    "split_keywords": [
        "qiskit",
        " quantum"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a3862f775a9ce2514da2ad2b0a5e52640536cbd6dcc1b5e0f6a48297ede96dcb",
                "md5": "9e2c3a216b7bf4631c0684213146ccfa",
                "sha256": "3d84aff2df00d0642a9fcb53cf7f7442e62d65d3bbe13e191bc078b2ee474dc6"
            },
            "downloads": -1,
            "filename": "qiskit_ibm_provider-0.11.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9e2c3a216b7bf4631c0684213146ccfa",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 249949,
            "upload_time": "2024-04-17T14:49:05",
            "upload_time_iso_8601": "2024-04-17T14:49:05.691735Z",
            "url": "https://files.pythonhosted.org/packages/a3/86/2f775a9ce2514da2ad2b0a5e52640536cbd6dcc1b5e0f6a48297ede96dcb/qiskit_ibm_provider-0.11.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3b75a3a940de9adbd2c9b85b12e8401a6cbf9b4b6b41d3b65fde64980eaa865e",
                "md5": "1b2752d91a03ab13fb478455c8f04b04",
                "sha256": "31a29701120dd0b27e1d8e691b4e7262580cda6f85b85610697577920d8c2f0c"
            },
            "downloads": -1,
            "filename": "qiskit_ibm_provider-0.11.0.tar.gz",
            "has_sig": false,
            "md5_digest": "1b2752d91a03ab13fb478455c8f04b04",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 244845,
            "upload_time": "2024-04-17T14:49:07",
            "upload_time_iso_8601": "2024-04-17T14:49:07.424652Z",
            "url": "https://files.pythonhosted.org/packages/3b/75/a3a940de9adbd2c9b85b12e8401a6cbf9b4b6b41d3b65fde64980eaa865e/qiskit_ibm_provider-0.11.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-17 14:49:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Qiskit",
    "github_project": "qiskit-ibm-provider",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "qiskit-ibm-provider"
}
        
Elapsed time: 0.28026s