# Azure Quantum #
[/_apis/build/status/microsoft.qdk-python?branchName=main)](https://dev.azure.com/ms-quantum-public/Microsoft%20Quantum%20(public)/_build/latest?definitionId=32&branchName=main) [](https://badge.fury.io/py/azure-quantum)
Azure Quantum is Microsoft's cloud service for running Quantum Computing programs and circuits with our quantum partners and technologies. The `azure-quantum` package for Python provides functionality for interacting with Azure Quantum workspaces, including creating jobs, listing jobs, and retrieving job results. For more information, view the [Azure Quantum Documentation](https://learn.microsoft.com/en-us/azure/quantum/).
This package supports submitting quantum programs or circuits written with Python. To submit quantum programs written with Q#, Microsoft's Domain-specific language for Quantum Programming, view [Submit Q# Jobs to Azure Quantum](https://learn.microsoft.com/azure/quantum/how-to-submit-jobs).
## Installation ##
The package is released on PyPI and can be installed via `pip`:
```bash
pip install azure-quantum
```
To use `azure-quantum` for submitting quantum circuits expressed with [Qiskit](https://pypi.org/project/qiskit), install with optional dependencies:
```bash
pip install azure-quantum[qiskit]
```
To use `azure-quantum` for submitting quantum circuits expressed with [Cirq](https://pypi.org/project/cirq), install with optional dependencies:
```bash
pip install azure-quantum[cirq]
```
## Getting started and Quickstart guides ##
To work in Azure Quantum, you need an Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/). Follow the [Create an Azure Quantum workspace](https://learn.microsoft.com/azure/quantum/how-to-create-workspace) how-to guide to set up your Workspace and enable your preferred providers.
To get started, visit the following Quickstart guides:
- [Quickstart: Submit a circuit with Qiskit](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-qiskit)
- [Quickstart: Submit a circuit with Cirq](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-qiskit)
- [Quickstart: Submit a circuit with a provider-specific format](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-provider-format).
## General usage ##
To connect to your Azure Quantum Workspace, go to the [Azure Portal](https://portal.azure.com), navigate to your Workspace and copy-paste the resource ID and location into the code snippet below.
```python
from azure.quantum import Workspace
# Enter your Workspace details (resource ID and location) below
workspace = Workspace(
resource_id="",
location=""
)
```
### List all targets ###
To list all targets that are available to your workspace, run
```python
workspace.get_targets()
```
### Submit a quantum program or circuit ###
First, define a quantum program or circuit, and create a job by submitting it to one of the available targets:
```python
# Enter target name below
target = workspace.get_targets("mytarget")
# Submit quantum program or circuit
job = target.submit(my_quantum_program)
# Wait for job to complete and fetch results
result = job.get_results()
```
## Examples ##
You can find example Python scripts that use the Azure Quantum Python API in the [examples](https://github.com/microsoft/qdk-python/tree/main/azure-quantum/examples) directory.
## Contributing ##
For details on contributing to this package, see the [contributing guide](https://github.com/microsoft/qdk-python/blob/main/CONTRIBUTING.md).
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit
https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Support ##
If you run into any problems or bugs using this package, please head over to the [issues](https://github.com/microsoft/qdk-python/issues) page and open a new issue, if it does not already exist.
Raw data
{
"_id": null,
"home_page": "https://github.com/microsoft/azure-quantum-python",
"name": "azure-quantum",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Microsoft",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f3/e5/49d165f196681a9530891d97f339a444df410ce4063737bbe8450f31ff1b/azure-quantum-2.0.1.tar.gz",
"platform": null,
"description": "\n\n# Azure Quantum #\n\n[/_apis/build/status/microsoft.qdk-python?branchName=main)](https://dev.azure.com/ms-quantum-public/Microsoft%20Quantum%20(public)/_build/latest?definitionId=32&branchName=main) [](https://badge.fury.io/py/azure-quantum)\n\nAzure Quantum is Microsoft's cloud service for running Quantum Computing programs and circuits with our quantum partners and technologies. The `azure-quantum` package for Python provides functionality for interacting with Azure Quantum workspaces, including creating jobs, listing jobs, and retrieving job results. For more information, view the [Azure Quantum Documentation](https://learn.microsoft.com/en-us/azure/quantum/).\n\nThis package supports submitting quantum programs or circuits written with Python. To submit quantum programs written with Q#, Microsoft's Domain-specific language for Quantum Programming, view [Submit Q# Jobs to Azure Quantum](https://learn.microsoft.com/azure/quantum/how-to-submit-jobs).\n\n## Installation ##\n\nThe package is released on PyPI and can be installed via `pip`:\n\n```bash\npip install azure-quantum\n```\n\nTo use `azure-quantum` for submitting quantum circuits expressed with [Qiskit](https://pypi.org/project/qiskit), install with optional dependencies:\n\n```bash\npip install azure-quantum[qiskit]\n```\n\nTo use `azure-quantum` for submitting quantum circuits expressed with [Cirq](https://pypi.org/project/cirq), install with optional dependencies:\n\n```bash\npip install azure-quantum[cirq]\n```\n\n## Getting started and Quickstart guides ##\n\nTo work in Azure Quantum, you need an Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/). Follow the [Create an Azure Quantum workspace](https://learn.microsoft.com/azure/quantum/how-to-create-workspace) how-to guide to set up your Workspace and enable your preferred providers.\n\nTo get started, visit the following Quickstart guides:\n\n- [Quickstart: Submit a circuit with Qiskit](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-qiskit)\n- [Quickstart: Submit a circuit with Cirq](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-qiskit)\n- [Quickstart: Submit a circuit with a provider-specific format](https://learn.microsoft.com/azure/quantum/quickstart-microsoft-provider-format).\n\n## General usage ##\n\nTo connect to your Azure Quantum Workspace, go to the [Azure Portal](https://portal.azure.com), navigate to your Workspace and copy-paste the resource ID and location into the code snippet below.\n\n```python\nfrom azure.quantum import Workspace\n\n# Enter your Workspace details (resource ID and location) below\nworkspace = Workspace(\n resource_id=\"\",\n location=\"\"\n)\n```\n\n### List all targets ###\n\nTo list all targets that are available to your workspace, run\n\n```python\nworkspace.get_targets()\n```\n\n### Submit a quantum program or circuit ###\n\nFirst, define a quantum program or circuit, and create a job by submitting it to one of the available targets:\n\n```python\n# Enter target name below\ntarget = workspace.get_targets(\"mytarget\")\n\n# Submit quantum program or circuit\njob = target.submit(my_quantum_program)\n\n# Wait for job to complete and fetch results\nresult = job.get_results()\n```\n\n## Examples ##\n\nYou can find example Python scripts that use the Azure Quantum Python API in the [examples](https://github.com/microsoft/qdk-python/tree/main/azure-quantum/examples) directory.\n\n## Contributing ##\n\nFor details on contributing to this package, see the [contributing guide](https://github.com/microsoft/qdk-python/blob/main/CONTRIBUTING.md).\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit\nhttps://cla.microsoft.com.\n\nWhen you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Support ##\n\nIf you run into any problems or bugs using this package, please head over to the [issues](https://github.com/microsoft/qdk-python/issues) page and open a new issue, if it does not already exist.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Python client for Azure Quantum",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://github.com/microsoft/azure-quantum-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5cc5743219c1962157fb7b6c5e73f75a38628b5f482e319b4e0323667a5793df",
"md5": "b7c3b4a0707071d7c2c6f36d3350c0b8",
"sha256": "d68465943985a4499484193c4813a97ada504f7000613fde4d4b9d3de3842479"
},
"downloads": -1,
"filename": "azure_quantum-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b7c3b4a0707071d7c2c6f36d3350c0b8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 142092,
"upload_time": "2024-05-03T23:41:11",
"upload_time_iso_8601": "2024-05-03T23:41:11.846587Z",
"url": "https://files.pythonhosted.org/packages/5c/c5/743219c1962157fb7b6c5e73f75a38628b5f482e319b4e0323667a5793df/azure_quantum-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f3e549d165f196681a9530891d97f339a444df410ce4063737bbe8450f31ff1b",
"md5": "8d96f84e67996fe50fd99634a0b6aa29",
"sha256": "6aa9ad5ff50561ee76618fa7859684bf7eb944eae4b9ffeb8989aebeddfde553"
},
"downloads": -1,
"filename": "azure-quantum-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "8d96f84e67996fe50fd99634a0b6aa29",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 108951,
"upload_time": "2024-05-03T23:41:09",
"upload_time_iso_8601": "2024-05-03T23:41:09.083450Z",
"url": "https://files.pythonhosted.org/packages/f3/e5/49d165f196681a9530891d97f339a444df410ce4063737bbe8450f31ff1b/azure-quantum-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 23:41:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoft",
"github_project": "azure-quantum-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "azure-quantum"
}
JSON
