# Qiskit IBM Experiment service
**Qiskit** is an open-source SDK for working with quantum computers at the level of circuits, algorithms, and application modules.
This project contains a service that allows accessing the **[IBM Quantum]**
experiment database.
## Installation
The provider can be installed via pip:
```bash
pip install qiskit-ibm-experiment
```
## Provider Setup
1. Create an IBM Quantum account or log in to your existing account by visiting the [IBM Quantum login page].
2. Ensure you have access to the experiment database.
3. Copy (and/or optionally regenerate) your API token from your
[IBM Quantum account page].
4. Take your token from step 2, here called `MY_API_TOKEN`, and save it by calling `IBMExperimentService.save_account()`:
```python
from qiskit_ibm_experiment import IBMExperimentService
IBMExperimentService.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 experiment service without using the API token:
```python
from qiskit_ibm_experiment import IBMExperimentService
service = IBMExperimentService()
# display current supported backends
print(service.backends())
# get the latest experiments in the DB
experiment_list = service.experiments()
```
You can also save specific configuration under a given name:
```python
from qiskit_ibm_experiment import IBMExperimentService
IBMExperimentService.save_account(name='my_config', token='MY_API_TOKEN')
```
And explicitly load it:
```python
from qiskit_ibm_experiment import IBMExperimentService
service = IBMExperimentService(name='my_config')
# display current supported backends
print(service.backends())
### Load Account from Environment Variables
Alternatively, the IBM Provider can discover credentials from environment variables:
```bash
export QISKIT_IBM_EXPERIMENT_TOKEN='MY_API_TOKEN'
export QISKIT_IBM_EXPERIMENT_URL='https://auth.quantum-computing.ibm.com/api'
```
Then instantiate the provider without any arguments and access the backends:
```python
from qiskit_ibm_experiment import IBMExperimentService
service = IBMExperimentService()
```
Environment variable take precedence over the default account saved to disk via `save_account`,
if one exists; but if the `name` parameter is given, the environment variables are ignored.
### Enable Account for Current Session
As another alternative, you can also enable an account just for the current session by instantiating the service with the token
```python
from qiskit_ibm_experiment import IBMExperimentService
service = IBMExperimentService(token='MY_API_TOKEN')
```
## Contribution Guidelines
If you'd like to contribute to IBM Quantum Experiment Service, 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).
## Next Steps
Now you're set up and ready to check out some of the other examples from our
[Qiskit Tutorial] repository.
## Authors and Citation
The Qiskit IBM Quantum Experiment Service 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-experiment/blob/main/CONTRIBUTING.md
[code of conduct]: https://github.com/Qiskit/qiskit-ibm-experiment/blob/main/CODE_OF_CONDUCT.md
[GitHub issues]: https://github.com/Qiskit/qiskit-ibm-experiment/issues
[slack]: https://qiskit.slack.com
[Stack Exchange]: https://quantumcomputing.stackexchange.com/questions/tagged/qiskit
[Qiskit Tutorial]: https://github.com/Qiskit/qiskit-tutorial
[many people]: https://github.com/Qiskit/qiskit-ibm-experiment/graphs/contributors
[BibTeX file]: https://github.com/Qiskit/qiskit/blob/master/Qiskit.bib
[Apache License 2.0]: https://github.com/Qiskit/qiskit-ibm-experiment/blob/main/LICENSE.txt
Raw data
{
"_id": null,
"home_page": "https://github.com/Qiskit/qiskit-ibm-experiment",
"name": "qiskit-ibm-experiment",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "qiskit sdk quantum api experiment ibm",
"author": "Qiskit Development Team",
"author_email": "qiskit@us.ibm.com",
"download_url": "https://files.pythonhosted.org/packages/b8/70/41affde88704599bf7bc36cf66b51ed5d1983b9632e646fedc6ef4760a6c/qiskit-ibm-experiment-0.4.8.tar.gz",
"platform": null,
"description": "# Qiskit IBM Experiment service\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 service that allows accessing the **[IBM Quantum]**\nexperiment database.\n\n## Installation\nThe provider can be installed via pip:\n\n```bash\npip install qiskit-ibm-experiment\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\n2. Ensure you have access to the experiment database.\n\n3. Copy (and/or optionally regenerate) your API token from your\n [IBM Quantum account page].\n\n4. Take your token from step 2, here called `MY_API_TOKEN`, and save it by calling `IBMExperimentService.save_account()`:\n\n ```python\n from qiskit_ibm_experiment import IBMExperimentService\n IBMExperimentService.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 \n Once saved you can then instantiate the experiment service without using the API token:\n\n ```python\n from qiskit_ibm_experiment import IBMExperimentService\n service = IBMExperimentService()\n\n # display current supported backends\n print(service.backends())\n\n # get the latest experiments in the DB\n experiment_list = service.experiments()\n ```\n \n You can also save specific configuration under a given name:\n \n ```python\n from qiskit_ibm_experiment import IBMExperimentService\n IBMExperimentService.save_account(name='my_config', token='MY_API_TOKEN')\n ```\n \n And explicitly load it:\n ```python\n from qiskit_ibm_experiment import IBMExperimentService\n service = IBMExperimentService(name='my_config')\n\n # display current supported backends\n print(service.backends())\n\n### Load Account from Environment Variables\nAlternatively, the IBM Provider can discover credentials from environment variables:\n```bash\nexport QISKIT_IBM_EXPERIMENT_TOKEN='MY_API_TOKEN'\nexport QISKIT_IBM_EXPERIMENT_URL='https://auth.quantum-computing.ibm.com/api'\n```\n\nThen instantiate the provider without any arguments and access the backends:\n```python\nfrom qiskit_ibm_experiment import IBMExperimentService\nservice = IBMExperimentService()\n```\n\nEnvironment variable take precedence over the default account saved to disk via `save_account`,\nif one exists; but if the `name` parameter is given, the environment variables are ignored.\n\n### Enable Account for Current Session\nAs another alternative, you can also enable an account just for the current session by instantiating the service with the token\n\n```python\nfrom qiskit_ibm_experiment import IBMExperimentService\nservice = IBMExperimentService(token='MY_API_TOKEN')\n```\n\n## Contribution Guidelines\n\nIf you'd like to contribute to IBM Quantum Experiment Service, 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## Next Steps\n\nNow you're set up and ready to check out some of the other examples from our\n[Qiskit Tutorial] repository.\n\n## Authors and Citation\n\nThe Qiskit IBM Quantum Experiment Service 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[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-experiment/blob/main/CONTRIBUTING.md\n[code of conduct]: https://github.com/Qiskit/qiskit-ibm-experiment/blob/main/CODE_OF_CONDUCT.md\n[GitHub issues]: https://github.com/Qiskit/qiskit-ibm-experiment/issues\n[slack]: https://qiskit.slack.com\n[Stack Exchange]: https://quantumcomputing.stackexchange.com/questions/tagged/qiskit\n[Qiskit Tutorial]: https://github.com/Qiskit/qiskit-tutorial\n[many people]: https://github.com/Qiskit/qiskit-ibm-experiment/graphs/contributors\n[BibTeX file]: https://github.com/Qiskit/qiskit/blob/master/Qiskit.bib\n[Apache License 2.0]: https://github.com/Qiskit/qiskit-ibm-experiment/blob/main/LICENSE.txt\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Qiskit IBM Experiment service for accessing the quantum experiment interface at IBM",
"version": "0.4.8",
"project_urls": {
"Bug Tracker": "https://github.com/Qiskit/qiskit-ibm-experiment/issues",
"Documentation": "https://qiskit-extensions.github.io/qiskit-ibm-experiment",
"Homepage": "https://github.com/Qiskit/qiskit-ibm-experiment",
"Source Code": "https://github.com/Qiskit/qiskit-ibm-experiment"
},
"split_keywords": [
"qiskit",
"sdk",
"quantum",
"api",
"experiment",
"ibm"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6a8182966b0d9703a1c4732b48953510179b2baaacac31e0eb7e5c29a63d4eb7",
"md5": "1ab5d1ec0dc5417e6ee348d57d7039e4",
"sha256": "0924fff8de7f86a6fbf77895bda467840450cbc721b114de709cc45071bfc4b5"
},
"downloads": -1,
"filename": "qiskit_ibm_experiment-0.4.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1ab5d1ec0dc5417e6ee348d57d7039e4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 57300,
"upload_time": "2024-09-05T13:25:52",
"upload_time_iso_8601": "2024-09-05T13:25:52.576935Z",
"url": "https://files.pythonhosted.org/packages/6a/81/82966b0d9703a1c4732b48953510179b2baaacac31e0eb7e5c29a63d4eb7/qiskit_ibm_experiment-0.4.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b87041affde88704599bf7bc36cf66b51ed5d1983b9632e646fedc6ef4760a6c",
"md5": "c45331cb24e8c141ec0a983eb6ee7aa6",
"sha256": "f5866b63fde3247008c578286b8bf5a61493e0d9839467f0d1fcfa24f45a9077"
},
"downloads": -1,
"filename": "qiskit-ibm-experiment-0.4.8.tar.gz",
"has_sig": false,
"md5_digest": "c45331cb24e8c141ec0a983eb6ee7aa6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 66303,
"upload_time": "2024-09-05T13:25:54",
"upload_time_iso_8601": "2024-09-05T13:25:54.569832Z",
"url": "https://files.pythonhosted.org/packages/b8/70/41affde88704599bf7bc36cf66b51ed5d1983b9632e646fedc6ef4760a6c/qiskit-ibm-experiment-0.4.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-05 13:25:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Qiskit",
"github_project": "qiskit-ibm-experiment",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "qiskit-ibm-experiment"
}
JSON
