# cuQuantum Python
## Documentation
Please visit the [NVIDIA cuQuantum Python documentation](https://docs.nvidia.com/cuda/cuquantum/latest/python).
For instructions on installing *cuQuantum Python*, refer to our
[getting started section](../getting-started/index.rst)
## Building and installing cuQuantum Python from source
### Requirements
The build-time dependencies of the cuQuantum Python package include:
* CUDA Toolkit 11.x or 12.x
* cuStateVec 1.4.0+
* cuTensorNet 2.5.0+
* Python 3.10+
* Cython >=0.29.22,<3
* pip 21.3.1+
* [packaging](https://packaging.pypa.io/en/latest/)
* setuptools 61.0.0+
* wheel 0.34.0+
Except for CUDA and Python, the rest of the build-time dependencies are handled by the new PEP-517-based build system (see Step 7 below).
To compile and install cuQuantum Python from source, please follow the steps below:
1. Clone the [NVIDIA/cuQuantum](https://github.com/NVIDIA/cuQuantum) repository: `git clone https://github.com/NVIDIA/cuQuantum`
2. Set `CUDA_PATH` to point to your CUDA installation
3. [optional] Set `CUQUANTUM_ROOT` to point to your cuQuantum installation
4. [optional] Set `CUTENSOR_ROOT` to point to your cuTENSOR installation
5. [optional] Make sure cuQuantum and cuTENSOR are visible in your `LD_LIBRARY_PATH`
6. Switch to the directory containing the Python implementation: `cd cuQuantum/python`
7. Build and install:
- Run `pip install .` if you skip Step 3-5 above
- Run `pip install -v --no-deps --no-build-isolation .` otherwise (advanced)
Notes:
- For Step 7, if you are building from source for testing/developing purposes you'd likely want to insert a `-e` flag before the last period (so `pip ... .` becomes `pip ... -e .`):
* `-e`: use the "editable" (in-place) mode
* `-v`: enable more verbose output
* `--no-deps`: avoid installing the *run-time* dependencies
* `--no-build-isolation`: reuse the current Python environment instead of creating a new one for building the package (this avoids installing any *build-time* dependencies)
- As an alternative to setting `CUQUANTUM_ROOT`, `CUSTATEVEC_ROOT` and `CUTENSORNET_ROOT` can be set to point to the cuStateVec and the cuTensorNet libraries, respectively. The latter two environment variables take precedence if defined.
- Please ensure that you use consistent binaries and packages for either CUDA 11 or 12. Mixing-and-matching will result in undefined behavior.
## Running
### Requirements
Runtime dependencies of the cuQuantum Python package include:
* An NVIDIA GPU with compute capability 7.0+
* Driver: Linux (450.80.02+ for CUDA 11, 525.60.13+ for CUDA 12)
* CUDA Toolkit 11.x or 12.x
* cuStateVec 1.4.0+
* cuTensorNet 2.5.0+
* Python 3.10+
* NumPy v1.21+
* CuPy v13.0.0+ (see [installation guide](https://docs.cupy.dev/en/stable/install.html))
* PyTorch v1.10+ (optional, see [installation guide](https://pytorch.org/get-started/locally/))
* Qiskit v0.24.0+ (optional, see [installation guide](https://qiskit.org/documentation/getting_started.html))
* Cirq v0.6.0+ (optional, see [installation guide](https://quantumai.google/cirq/install))
* mpi4py v3.1.0+ (optional, see [installation guide](https://mpi4py.readthedocs.io/en/stable/install.html))
If you install everything from conda-forge, all the required dependencies are taken care for you (except for the driver).
If you install the pip wheels, CuPy, cuTENSOR and cuQuantum (but not CUDA Toolkit or the driver,
please make sure the CUDA libraries are visible through your `LD_LIBRARY_PATH`) are installed for you.
If you build cuQuantum Python from source, please make sure that the paths to the CUDA, cuQuantum, and cuTENSOR libraries are added
to your `LD_LIBRARY_PATH` environment variable, and that a compatible CuPy is installed.
Known issues:
- If a system has multiple copies of cuTENSOR, one of which is installed in a default system path, the Python runtime could pick it up despite cuQuantum Python is linked to another copy installed elsewhere, potentially causing a version-mismatch error. The proper fix is to remove cuTENSOR from the system paths to ensure the visibility of the proper copy. **DO NOT ATTEMPT** to use `LD_PRELOAD` to overwrite it --- it could cause hard to debug behaviors!
- In certain environments, if PyTorch is installed `import cuquantum` could fail (with a segmentation fault). It is currently under investigation and a temporary workaround is to import `torch` before importing `cuquantum`.
- Please ensure that you use consistent binaries and packages for either CUDA 11 or 12. Mixing-and-matching will result in undefined behavior.
### Samples
Samples for demonstrating the usage of both low-level and high-level Python APIs are
available in the `samples` directory. The low-level API samples are 1:1 translations of the corresponding
samples written in C. The high-level API samples demonstrate pythonic usages of the cuTensorNet
library in Python.
## Testing
If pytest is installed, typing `pytest tests` at the command prompt in the Python source root directory will
run all tests. Some tests would be skipped if `cffi` is not installed or if the environment
variable `CUDA_PATH` is not set.
## Citing cuQuantum
Please click this Zenodo badge to see the citation format: [](https://doi.org/10.5281/zenodo.6385574)
Raw data
{
"_id": null,
"home_page": "https://developer.nvidia.com/cuquantum-sdk",
"name": "cuquantum-python-cu11",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "NVIDIA Corporation",
"author_email": "cuquantum-python@nvidia.com",
"download_url": null,
"platform": null,
"description": "# cuQuantum Python\n\n## Documentation\n\nPlease visit the [NVIDIA cuQuantum Python documentation](https://docs.nvidia.com/cuda/cuquantum/latest/python).\n\nFor instructions on installing *cuQuantum Python*, refer to our \n[getting started section](../getting-started/index.rst)\n\n## Building and installing cuQuantum Python from source\n\n### Requirements\n\nThe build-time dependencies of the cuQuantum Python package include:\n\n* CUDA Toolkit 11.x or 12.x\n* cuStateVec 1.4.0+\n* cuTensorNet 2.5.0+\n* Python 3.10+\n* Cython >=0.29.22,<3\n* pip 21.3.1+\n* [packaging](https://packaging.pypa.io/en/latest/)\n* setuptools 61.0.0+\n* wheel 0.34.0+\n\nExcept for CUDA and Python, the rest of the build-time dependencies are handled by the new PEP-517-based build system (see Step 7 below).\n\nTo compile and install cuQuantum Python from source, please follow the steps below:\n\n1. Clone the [NVIDIA/cuQuantum](https://github.com/NVIDIA/cuQuantum) repository: `git clone https://github.com/NVIDIA/cuQuantum`\n2. Set `CUDA_PATH` to point to your CUDA installation\n3. [optional] Set `CUQUANTUM_ROOT` to point to your cuQuantum installation\n4. [optional] Set `CUTENSOR_ROOT` to point to your cuTENSOR installation\n5. [optional] Make sure cuQuantum and cuTENSOR are visible in your `LD_LIBRARY_PATH`\n6. Switch to the directory containing the Python implementation: `cd cuQuantum/python`\n7. Build and install:\n - Run `pip install .` if you skip Step 3-5 above\n - Run `pip install -v --no-deps --no-build-isolation .` otherwise (advanced)\n\nNotes:\n- For Step 7, if you are building from source for testing/developing purposes you'd likely want to insert a `-e` flag before the last period (so `pip ... .` becomes `pip ... -e .`):\n * `-e`: use the \"editable\" (in-place) mode\n * `-v`: enable more verbose output\n * `--no-deps`: avoid installing the *run-time* dependencies\n * `--no-build-isolation`: reuse the current Python environment instead of creating a new one for building the package (this avoids installing any *build-time* dependencies)\n- As an alternative to setting `CUQUANTUM_ROOT`, `CUSTATEVEC_ROOT` and `CUTENSORNET_ROOT` can be set to point to the cuStateVec and the cuTensorNet libraries, respectively. The latter two environment variables take precedence if defined.\n- Please ensure that you use consistent binaries and packages for either CUDA 11 or 12. Mixing-and-matching will result in undefined behavior.\n\n\n## Running\n\n### Requirements\n\nRuntime dependencies of the cuQuantum Python package include:\n\n* An NVIDIA GPU with compute capability 7.0+\n* Driver: Linux (450.80.02+ for CUDA 11, 525.60.13+ for CUDA 12)\n* CUDA Toolkit 11.x or 12.x\n* cuStateVec 1.4.0+\n* cuTensorNet 2.5.0+\n* Python 3.10+\n* NumPy v1.21+\n* CuPy v13.0.0+ (see [installation guide](https://docs.cupy.dev/en/stable/install.html))\n* PyTorch v1.10+ (optional, see [installation guide](https://pytorch.org/get-started/locally/))\n* Qiskit v0.24.0+ (optional, see [installation guide](https://qiskit.org/documentation/getting_started.html))\n* Cirq v0.6.0+ (optional, see [installation guide](https://quantumai.google/cirq/install))\n* mpi4py v3.1.0+ (optional, see [installation guide](https://mpi4py.readthedocs.io/en/stable/install.html))\n\nIf you install everything from conda-forge, all the required dependencies are taken care for you (except for the driver).\n\nIf you install the pip wheels, CuPy, cuTENSOR and cuQuantum (but not CUDA Toolkit or the driver,\nplease make sure the CUDA libraries are visible through your `LD_LIBRARY_PATH`) are installed for you.\n\nIf you build cuQuantum Python from source, please make sure that the paths to the CUDA, cuQuantum, and cuTENSOR libraries are added\nto your `LD_LIBRARY_PATH` environment variable, and that a compatible CuPy is installed.\n\nKnown issues:\n- If a system has multiple copies of cuTENSOR, one of which is installed in a default system path, the Python runtime could pick it up despite cuQuantum Python is linked to another copy installed elsewhere, potentially causing a version-mismatch error. The proper fix is to remove cuTENSOR from the system paths to ensure the visibility of the proper copy. **DO NOT ATTEMPT** to use `LD_PRELOAD` to overwrite it --- it could cause hard to debug behaviors!\n- In certain environments, if PyTorch is installed `import cuquantum` could fail (with a segmentation fault). It is currently under investigation and a temporary workaround is to import `torch` before importing `cuquantum`.\n- Please ensure that you use consistent binaries and packages for either CUDA 11 or 12. Mixing-and-matching will result in undefined behavior.\n\n### Samples\n\nSamples for demonstrating the usage of both low-level and high-level Python APIs are\navailable in the `samples` directory. The low-level API samples are 1:1 translations of the corresponding\nsamples written in C. The high-level API samples demonstrate pythonic usages of the cuTensorNet\nlibrary in Python.\n\n\n## Testing\n\nIf pytest is installed, typing `pytest tests` at the command prompt in the Python source root directory will\nrun all tests. Some tests would be skipped if `cffi` is not installed or if the environment\nvariable `CUDA_PATH` is not set.\n\n\n## Citing cuQuantum\n\nPlease click this Zenodo badge to see the citation format: [](https://doi.org/10.5281/zenodo.6385574)\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "NVIDIA cuQuantum Python",
"version": "24.8.0",
"project_urls": {
"Bug Tracker": "https://github.com/NVIDIA/cuQuantum/issues",
"Documentation": "https://docs.nvidia.com/cuda/cuquantum/latest/python/",
"Homepage": "https://developer.nvidia.com/cuquantum-sdk",
"Source Code": "https://github.com/NVIDIA/cuQuantum",
"User Forum": "https://github.com/NVIDIA/cuQuantum/discussions"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d9510f9499b33707b8299c6c0d873a11aab5fb76ca0b86d8f0331f340874659e",
"md5": "0a8dde2d2fbab38786dc4920f269a09b",
"sha256": "9176c2e3f845f38cd85a45941a0e648c3212d613f907022bb6acfff3dc09b3b6"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp310-cp310-manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "0a8dde2d2fbab38786dc4920f269a09b",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.10",
"size": 3819507,
"upload_time": "2024-08-09T06:26:53",
"upload_time_iso_8601": "2024-08-09T06:26:53.492530Z",
"url": "https://files.pythonhosted.org/packages/d9/51/0f9499b33707b8299c6c0d873a11aab5fb76ca0b86d8f0331f340874659e/cuquantum_python_cu11-24.8.0-cp310-cp310-manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "135e1584190b5be258e573b953743b340316c320e9583e18d8b0ec918fdd4d43",
"md5": "d9da7e7258945be847baf9b23839f754",
"sha256": "4b90fd06418879788f25c00b51a4ea003ab87a018e2f601e2ad453da132bec1d"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp310-cp310-manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "d9da7e7258945be847baf9b23839f754",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.10",
"size": 3843836,
"upload_time": "2024-08-09T06:26:55",
"upload_time_iso_8601": "2024-08-09T06:26:55.783272Z",
"url": "https://files.pythonhosted.org/packages/13/5e/1584190b5be258e573b953743b340316c320e9583e18d8b0ec918fdd4d43/cuquantum_python_cu11-24.8.0-cp310-cp310-manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b068ab31acf6ab0befe3872e9447a128f0be51e28e7382a03503c5f2f7df27c4",
"md5": "61daceaace0fb1fd1f82c25e23e3875a",
"sha256": "3168aa3c677cb1b8b9cc2b0a348f00fa5c0cbf6b423c6970ea86a2e73f2b8d6c"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp311-cp311-manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "61daceaace0fb1fd1f82c25e23e3875a",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.10",
"size": 3970375,
"upload_time": "2024-08-09T06:26:58",
"upload_time_iso_8601": "2024-08-09T06:26:58.098074Z",
"url": "https://files.pythonhosted.org/packages/b0/68/ab31acf6ab0befe3872e9447a128f0be51e28e7382a03503c5f2f7df27c4/cuquantum_python_cu11-24.8.0-cp311-cp311-manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cae490e2d7d21bf31e2283f24a55fc45fdec7edc72c6734eb695094c0dfb1de2",
"md5": "bc7a4fff9b903a92e0a5ccadc2968d29",
"sha256": "53c2865280fde2e23d973746b3f39c71149c5084881256cdd40bd199bd19dc02"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp311-cp311-manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "bc7a4fff9b903a92e0a5ccadc2968d29",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.10",
"size": 3991608,
"upload_time": "2024-08-09T06:27:00",
"upload_time_iso_8601": "2024-08-09T06:27:00.547941Z",
"url": "https://files.pythonhosted.org/packages/ca/e4/90e2d7d21bf31e2283f24a55fc45fdec7edc72c6734eb695094c0dfb1de2/cuquantum_python_cu11-24.8.0-cp311-cp311-manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a67fc02093438c9c0b7a831520182ef736c693b67110f9e28f7564953f076f8",
"md5": "6fbf2bf9a7733e47f9f3baf4dc802188",
"sha256": "e708e696edda31d6f532c6fee441ccf7204da2c70c163304d3c3e73d25cd4eb5"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp312-cp312-manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "6fbf2bf9a7733e47f9f3baf4dc802188",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.10",
"size": 3835029,
"upload_time": "2024-08-09T06:27:02",
"upload_time_iso_8601": "2024-08-09T06:27:02.471662Z",
"url": "https://files.pythonhosted.org/packages/3a/67/fc02093438c9c0b7a831520182ef736c693b67110f9e28f7564953f076f8/cuquantum_python_cu11-24.8.0-cp312-cp312-manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b3276d1defe5a195c784d4a565a5d7e839fb4095e3b9fc86605bfd14987756bc",
"md5": "508caf935e9fd93807b7935f0926bbf9",
"sha256": "7217ce3af9797a12f31b568d50d8c09558e0b55a09d1c09f38dbf42479a31534"
},
"downloads": -1,
"filename": "cuquantum_python_cu11-24.8.0-cp312-cp312-manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "508caf935e9fd93807b7935f0926bbf9",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.10",
"size": 3861590,
"upload_time": "2024-08-09T06:27:04",
"upload_time_iso_8601": "2024-08-09T06:27:04.965698Z",
"url": "https://files.pythonhosted.org/packages/b3/27/6d1defe5a195c784d4a565a5d7e839fb4095e3b9fc86605bfd14987756bc/cuquantum_python_cu11-24.8.0-cp312-cp312-manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-09 06:26:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NVIDIA",
"github_project": "cuQuantum",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "cuquantum-python-cu11"
}
JSON
