# Q# Interoperability for Python #
The `qsharp-core` package for Python provides interoperability with the Quantum Development Kit and with the Q# language, making it easy to simulate Q# operations and functions from within Python.
For details on how to get started with Python and Q#, please see the [Getting Started with Python guide](https://docs.microsoft.com/azure/quantum/install-python-qdk).
You can also try our [Quantum Computing Fundamentals](https://aka.ms/learnqc) learning path to get familiar with the basic concepts of quantum computing, build quantum programs, and identify the kind of problems that can be solved.
## Installing with Anaconda ##
If you use Anaconda or Miniconda, installing the `qsharp` package will automatically include all dependencies:
```bash
conda install -c quantum-engineering qsharp
```
## Installing from Source ##
If you'd like to contribute to or experiment with the Python interoperability feature, it may be useful to install from source rather than from the `qsharp-core` package on the Python Package Index (PyPI).
To do so, make sure that you are in the `Python` directory, and run `setup.py` with the `install` argument:
```bash
cd iqsharp/src/Python/
python setup.py install
```
## Building the `qsharp-core` Package ##
The Python interoperability feature uses a standard `setuptools`-based packaging strategy.
To build a platform-independent wheel, run the setup script with `bdist_wheel` instead:
```bash
cd iqsharp/src/Python/
python setup.py bdist_wheel
```
By default, this will create a `qsharp-core` wheel in `dist/` with the version number set to 0.0.0.1.
To provide a more useful version number, set the `PYTHON_VERSION` environment variable before running `setup.py`.
## Support and Q&A
If you have questions about the Quantum Development Kit and the Q# language, or if you encounter issues while using any of the components of the kit, you can reach out to the quantum team and the community of users in [Stack Overflow](https://stackoverflow.com/questions/tagged/q%23) and in [Quantum Computing Stack Exchange](https://quantumcomputing.stackexchange.com/questions/tagged/q%23) tagging your questions with **q#**.
Raw data
{
"_id": null,
"home_page": "https://github.com/microsoft/iqsharp",
"name": "qsharp-core",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Microsoft",
"author_email": "que-contacts@microsoft.com",
"download_url": "https://files.pythonhosted.org/packages/41/d1/2bcb58026028b34c3f1b1ae2a82ba3177ee516bb134de25b7a4e821c83a0/qsharp-core-0.28.302812.tar.gz",
"platform": null,
"description": "# Q# Interoperability for Python #\r\n\r\nThe `qsharp-core` package for Python provides interoperability with the Quantum Development Kit and with the Q# language, making it easy to simulate Q# operations and functions from within Python.\r\n\r\nFor details on how to get started with Python and Q#, please see the [Getting Started with Python guide](https://docs.microsoft.com/azure/quantum/install-python-qdk).\r\n\r\nYou can also try our [Quantum Computing Fundamentals](https://aka.ms/learnqc) learning path to get familiar with the basic concepts of quantum computing, build quantum programs, and identify the kind of problems that can be solved.\r\n\r\n## Installing with Anaconda ##\r\n\r\nIf you use Anaconda or Miniconda, installing the `qsharp` package will automatically include all dependencies:\r\n\r\n```bash\r\nconda install -c quantum-engineering qsharp\r\n```\r\n\r\n## Installing from Source ##\r\n\r\nIf you'd like to contribute to or experiment with the Python interoperability feature, it may be useful to install from source rather than from the `qsharp-core` package on the Python Package Index (PyPI).\r\nTo do so, make sure that you are in the `Python` directory, and run `setup.py` with the `install` argument:\r\n\r\n```bash\r\ncd iqsharp/src/Python/\r\npython setup.py install\r\n```\r\n\r\n## Building the `qsharp-core` Package ##\r\n\r\nThe Python interoperability feature uses a standard `setuptools`-based packaging strategy.\r\nTo build a platform-independent wheel, run the setup script with `bdist_wheel` instead:\r\n\r\n```bash\r\ncd iqsharp/src/Python/\r\npython setup.py bdist_wheel\r\n```\r\n\r\nBy default, this will create a `qsharp-core` wheel in `dist/` with the version number set to 0.0.0.1.\r\nTo provide a more useful version number, set the `PYTHON_VERSION` environment variable before running `setup.py`.\r\n\r\n## Support and Q&A\r\n\r\nIf you have questions about the Quantum Development Kit and the Q# language, or if you encounter issues while using any of the components of the kit, you can reach out to the quantum team and the community of users in [Stack Overflow](https://stackoverflow.com/questions/tagged/q%23) and in [Quantum Computing Stack Exchange](https://quantumcomputing.stackexchange.com/questions/tagged/q%23) tagging your questions with **q#**.\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Python client for Q#, a domain-specific quantum programming language",
"version": "0.28.302812",
"project_urls": {
"Homepage": "https://github.com/microsoft/iqsharp"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec4e827331b500fd6f8c346a8fab4b0095155db98e43f56c322c3c74bc7e0907",
"md5": "5087143eb6168e5dafbe8a8775647cbf",
"sha256": "4e667002079efe0e2515b9832794e8ee379bc5e3c55efdb5b77e1ebc936de760"
},
"downloads": -1,
"filename": "qsharp_core-0.28.302812-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5087143eb6168e5dafbe8a8775647cbf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 43032,
"upload_time": "2023-09-15T15:32:27",
"upload_time_iso_8601": "2023-09-15T15:32:27.250768Z",
"url": "https://files.pythonhosted.org/packages/ec/4e/827331b500fd6f8c346a8fab4b0095155db98e43f56c322c3c74bc7e0907/qsharp_core-0.28.302812-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "41d12bcb58026028b34c3f1b1ae2a82ba3177ee516bb134de25b7a4e821c83a0",
"md5": "f4cff4cd3c630c499e246153f72f8016",
"sha256": "1b6324792f6892e2a29f88473dade06e15b92ea8819824405f0e7ecb7cea4de2"
},
"downloads": -1,
"filename": "qsharp-core-0.28.302812.tar.gz",
"has_sig": false,
"md5_digest": "f4cff4cd3c630c499e246153f72f8016",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 34388,
"upload_time": "2023-09-15T15:32:36",
"upload_time_iso_8601": "2023-09-15T15:32:36.495261Z",
"url": "https://files.pythonhosted.org/packages/41/d1/2bcb58026028b34c3f1b1ae2a82ba3177ee516bb134de25b7a4e821c83a0/qsharp-core-0.28.302812.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-15 15:32:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoft",
"github_project": "iqsharp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "qsharp-core"
}