cudaq 0.9.0__tar.gz

cudaq-0.9.0/CITATION.cff

@@ -0,0 +1,11 @@
+cff-version: 1.2.0
+title: 'CUDA-Q'
+message: 'If you use this software, please cite it as below.'
+authors:
+  - name: "The CUDA-Q development team"
+license: Apache-2.0
+license-url: "https://github.com/NVIDIA/cuda-quantum/blob/main/LICENSE"
+repository-code: "https://github.com/NVIDIA/cuda-quantum"
+type: software
+url: "https://github.com/NVIDIA/cuda-quantum"
+# doi: 

cudaq-0.9.0/LICENSE

@@ -0,0 +1,16 @@
+Apache License Version 2.0
+
+Copyright (c) 2023 - 2024 NVIDIA Corporation & Affiliates
+All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

cudaq-0.9.0/NOTICE

@@ -0,0 +1,190 @@
+CUDA-Q
+
+This product includes software developed by NVIDIA corporation and affiliates and includes material from third parties. It includes work released under the following licenses:
+
+----------------------------------------------------------------
+
+LLVM - Apache License 2.0 with LLVM Exceptions
+<https://github.com/llvm/llvm-project> and <https://github.com/llvm/circt/>
+
+Originally developed by University of Illinois at Urbana Campaign.
+The incorporated source code and its license can be found as as submodule on the CUDA-Q repository.
+License at <https://github.com/llvm/llvm-project/blob/main/LICENSE.TXT>
+
+----------------------------------------------------------------
+
+Eigen - various licenses, primarily MPL2 and BSD
+<https://gitlab.com/libeigen/eigen>
+
+The incorporated source code and its licenses can be found as a submodule on the CUDA-Q repository.
+See also <https://gitlab.com/libeigen/eigen/-/blob/master/COPYING.README>.
+
+----------------------------------------------------------------
+
+PyBind11 - BSD-style license
+<https://github.com/pybind/pybind11>
+
+The source code is based on the work originally developed by Wenzel Jakob
+License at <https://github.com/pybind/pybind11/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+Ensmallen - 3-Clause BSD License
+<https://github.com/mlpack/ensmallen>
+
+The incorporated source code and its license can be found as a submodule on the CUDA-Q repository.
+License at <https://github.com/mlpack/ensmallen/blob/master/LICENSE.txt>
+
+----------------------------------------------------------------
+
+Armadillo - Apache License 2.0
+<https://gitlab.com/conradsnicta/armadillo-code>
+
+The incorporated source code and its license can be found as as submodule on the CUDA-Q repository.
+License at <https://gitlab.com/conradsnicta/armadillo-code/-/blob/12.0.x/LICENSE.txt>
+
+----------------------------------------------------------------
+
+NLohmann JSON - MIT License
+<https://github.com/nlohmann/json>
+
+The source code is based on the work originally developed by Niels Lohmann
+License at <https://github.com/nlohmann/json/blob/develop/LICENSE.MIT>
+
+----------------------------------------------------------------
+
+Quantum++ - MIT License
+<https://github.com/softwareqinc/qpp/>
+
+The source code is based on the work originally developed by SoftwareQ Inc
+License at <https://github.com/softwareQinc/qpp/blob/main/LICENSE>
+
+----------------------------------------------------------------
+
+{fmt} - MIT License
+<https://github.com/fmtlib/fmt>
+
+Originally developed by Victor Zverovich and contributors.
+The incorporated source code and its license can be found as a submodule on the CUDA-Q repository.
+License at <https://github.com/fmtlib/fmt/blob/master/LICENSE.rst>
+
+----------------------------------------------------------------
+
+SPDLog - MIT License
+<https://github.com/gabime/spdlog>
+
+Originally developed by Gabi Melman.
+The incorporated source code and its license can be found as a submodule on the CUDA-Q repository.
+License at <https://github.com/gabime/spdlog/blob/v1.x/LICENSE>
+
+----------------------------------------------------------------
+
+NLopt - various licenses, primarily MIT
+<https://github.com/stevengj/nlopt>
+
+The source code includes a subset of the optimization libraries combined in NLopt.
+The relevant code included with CUDA-Q is based on work that is licensed under MIT license. More information about the original authors and copyright holders can be found on the respository in the folder for the respective algorithm.
+See also <https://github.com/stevengj/nlopt/blob/master/COPYING>
+
+----------------------------------------------------------------
+
+ExaTN - 3-Clause BSD License
+<https://github.com/ORNL-QCI/exatn>
+
+License at <https://github.com/ORNL-QCI/exatn/blob/devel/LICENSE>
+
+----------------------------------------------------------------
+
+CuQuantum - 3-Clause BSD License
+<https://github.com/NVIDIA/cuQuantum>
+
+License at <https://github.com/NVIDIA/cuQuantum/blob/main/LICENSE>
+
+----------------------------------------------------------------
+
+C++ Requests - MIT License
+<https://github.com/libcpr/cpr>
+
+Originally developed by Huu Nguyen, libcpr and contributors.
+License at <https://github.com/libcpr/cpr/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+BLAS - custom license
+<https://netlib.org/blas/>
+
+See also <https://netlib.org/blas/#_licensing>
+
+----------------------------------------------------------------
+
+XTL - BSD-3-Clause
+<https://github.com/xtensor-stack/xtl>
+
+License at <https://github.com/xtensor-stack/xtensor/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+XTensor - BSD-3-Clause
+<https://github.com/xtensor-stack/xtensor>
+
+License at <https://github.com/xtensor-stack/xtensor/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+zlib - custom license
+<https://github.com/madler/zlib>
+
+License at <https://github.com/madler/zlib/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+OpenSSL - Apache License 2.0
+<https://www.openssl.org>
+
+Licenses at <https://www.openssl.org/source/license.html>
+
+----------------------------------------------------------------
+
+Curl - custom license
+<https://github.com/curl/curl/>
+
+Licenses at <https://github.com/curl/curl/tree/master/LICENSES>
+
+----------------------------------------------------------------
+
+ASIO - Boost Software License - Version 1.0
+<https://github.com/chriskohlhoff/asio>
+
+License at <https://github.com/chriskohlhoff/asio/blob/master/asio/LICENSE_1_0.txt>
+
+----------------------------------------------------------------
+
+Crow - BSD-3-Clause
+<https://github.com/CrowCpp/Crow>
+
+License at <https://github.com/CrowCpp/Crow/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+Tweedledum - MIT License
+<https://github.com/boschmitt/tweedledum>
+
+License at <https://github.com/boschmitt/tweedledum/blob/master/LICENSE>
+
+----------------------------------------------------------------
+
+Stim - Apache License 2.0
+<https://github.com/quantumlib/Stim>
+
+The incorporated source code and its license can be found as a submodule on the CUDA-Q repository.
+License at <https://github.com/quantumlib/Stim/blob/main/LICENSE>
+
+----------------------------------------------------------------
+
+AWS SDK for C++ - Apache License 2.0
+<https://github.com/aws/aws-sdk-cpp>
+
+The incorporated source code and its license can be found as a submodule on the CUDA-Q repository.
+License at <https://github.com/aws/aws-sdk-cpp/blob/main/LICENSE>
+
+----------------------------------------------------------------

cudaq-0.9.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.1
+Name: cudaq
+Version: 0.9.0
+Summary: Python bindings for the CUDA-Q toolkit for heterogeneous quantum-classical workflows.
+Author: NVIDIA Corporation & Affiliates
+Maintainer: NVIDIA Corporation & Affiliates
+License: Apache License Version 2.0
+        
+        Copyright (c) 2023 - 2024 NVIDIA Corporation & Affiliates
+        All rights reserved.
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+            http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+Project-URL: Homepage, https://developer.nvidia.com/cuda-q
+Project-URL: Documentation, https://nvidia.github.io/cuda-quantum
+Project-URL: Repository, https://github.com/NVIDIA/cuda-quantum
+Project-URL: Releases, https://nvidia.github.io/cuda-quantum/latest/releases.html
+Keywords: cudaq,cuda-quantum,cuda,quantum,quantum computing,nvidia,high-performance computing
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: GPU :: NVIDIA CUDA
+Classifier: Environment :: GPU :: NVIDIA CUDA :: 11
+Classifier: Environment :: GPU :: NVIDIA CUDA :: 12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: CITATION.cff
+Provides-Extra: chemistry
+Requires-Dist: scipy==1.10.1; extra == "chemistry"
+Requires-Dist: openfermionpyscf==0.5; extra == "chemistry"
+Requires-Dist: h5py<3.11; extra == "chemistry"
+Provides-Extra: visualization
+Requires-Dist: qutip<5; extra == "visualization"
+Requires-Dist: matplotlib>=3.5; extra == "visualization"
+
+# Welcome to the CUDA-Q Python API
+
+CUDA-Q is a comprehensive framework for quantum programming. It features:
+
+- A programming model which extends C++ and Python with quantum kernels,
+  enabling high-level programming in familiar languages
+- A high-performance quantum compiler, `nvq++`, based on the industry standard
+  LLVM toolchain
+- Interoperability with all of the leading models and tools for accelerated
+  computing, including CUDA, ISO standard parallelism, OpenMP, and OpenACC
+- The ability to utilize and seamlessly switch between different quantum
+  technologies, including state-of-the-art simulator backends with NVIDIA
+  cuQuantum and a number of different physical quantum processors (QPUs)
+
+The CUDA-Q Python wheels contain the Python API and core components of CUDA-Q.
+This package installs CUDA-Q binaries that are compatible with a CUDA version
+11.x (where x >= 8) or 12.x. More information about available packages as
+well as a link to the documentation and examples for each version can be found
+in the [release notes][cudaq_docs_releases]. System and compatibility
+requirements are listed in the Installation Guide of the linked documentation.
+
+**Note**: CUDA-Q is currently only supported on Linux operating systems using
+`x86_64` or `aarch64`/`arm64` processors.
+
+[cudaq_docs_releases]:
+    https://nvidia.github.io/cuda-quantum/latest/releases.html
+
+## Installation Including GPU-Acceleration
+
+[//]: # (Begin complete install)
+
+CUDA-Q does not require a GPU to use, but some components are GPU-accelerated.
+
+Getting started with CUDA-Q on `x86_64` platforms simply requires `pip install
+cudaq`. Please make sure your `pip` version is \>= 24.0.
+If you have an NVIDIA GPU on your host system, you will be
+able to use it without any further installation steps.
+
+> **Important:** 
+> Please check if you have an existing installation of the `cuda-quantum`, `cudaq-quantum-cu11`, or `cuda-quantum-cu12` package, and uninstall it prior to installation. Different CUDA-Q binary distributions may conflict with each other causing issues.
+
+
+If you want to perform multi-GPU simulations, or if you are using
+`aarch64`/`arm64` processors, additional components must be installed. We
+recommend using [Conda](https://docs.conda.io/en/latest/) to do so. If you are
+not already using Conda, you can install a minimal version following the
+instructions [here](https://docs.anaconda.com/miniconda/). The following
+commands will create and activate a complete environment for CUDA-Q with all its
+dependencies:
+
+[//]: # (Begin conda install)
+
+```console
+cuda_version=11.8.0 # set this variable to version 11.x (where x >= 8) or 12.x
+conda create -y -n cudaq-env python=3.11 pip
+conda install -y -n cudaq-env -c "nvidia/label/cuda-${cuda_version}" cuda
+conda install -y -n cudaq-env -c conda-forge mpi4py openmpi cxx-compiler
+conda env config vars set -n cudaq-env LD_LIBRARY_PATH="$CONDA_PREFIX/envs/cudaq-env/lib:$LD_LIBRARY_PATH"
+conda env config vars set -n cudaq-env MPI_PATH=$CONDA_PREFIX/envs/cudaq-env
+conda activate cudaq-env
+pip install cudaq
+source $CONDA_PREFIX/lib/python3.11/site-packages/distributed_interfaces/activate_custom_mpi.sh
+```
+
+[//]: # (End conda install)
+
+You must configure MPI by setting the following environment variables:
+
+[//]: # (Begin ompi setup)
+
+```console
+export OMPI_MCA_opal_cuda_support=true OMPI_MCA_btl='^openib'
+```
+
+[//]: # (End ompi setup)
+
+*If you do not set these variables you may encounter a segmentation fault.*
+
+**Important**: It is *not* sufficient to set these variable within the Conda
+environment, like the commands above do for `LD_LIBRARY_PATH`. To avoid having
+to set them every time you launch a new shell, we recommend adding them to
+`~/.profile` (create the file if it does not exist), and to `~/.bash_profile` or
+`~/.bash_login` if such a file exists.
+
+[//]: # (End complete install)
+
+MPI uses [SSH](https://en.wikipedia.org/wiki/Secure_Shell) or
+[RSH](https://en.wikipedia.org/wiki/Remote_Shell) to communicate with each node
+unless another resource manager, such as
+[SLURM](https://slurm.schedmd.com/overview.html), is used. If you are
+encountering an error "The value of the MCA parameter `plm_rsh_agent` was set to
+a path that could not be found", please make sure you have an SSH Client
+installed.
+
+## Running CUDA-Q
+
+You should now be able to import CUDA-Q and start building quantum programs in
+Python!
+
+```console
+import cudaq
+
+kernel = cudaq.make_kernel()
+qubit = kernel.qalloc()
+kernel.x(qubit)
+kernel.mz(qubit)
+
+result = cudaq.sample(kernel)
+```
+
+Additional examples and documentation are linked in the [release
+notes][cudaq_docs_releases].
+
+## Contributing
+
+There are many ways in which you can get involved with CUDA-Q. If you are
+interested in developing quantum applications with CUDA-Q, our [GitHub
+repository][github_link] is a great place to get started! For more information
+about contributing to the CUDA-Q platform, please take a look at
+[Contributing.md](https://github.com/NVIDIA/cuda-quantum/blob/main/Contributing.md).
+
+## License
+
+CUDA-Q is an open source project. The source code is available on
+[GitHub][github_link] and licensed under [Apache License
+2.0](https://github.com/NVIDIA/cuda-quantum/blob/main/LICENSE). CUDA-Q makes use
+of the NVIDIA cuQuantum SDK to enable high-performance simulation, which is held
+to its own respective license.
+
+[github_link]: https://github.com/NVIDIA/cuda-quantum/
+
+## Feedback
+
+Please let us know your feedback and ideas for the CUDA-Q platform in the
+[Discussions][discussions] tab of our [GitHub repository][github_repo], or [file
+an issue][cuda_quantum_issues]. To report security concerns please reach out to
+[cuda-quantum@nvidia.com](mailto:cuda-quantum@nvidia.com).
+
+[discussions]: https://github.com/NVIDIA/cuda-quantum/discussions
+[cuda_quantum_issues]: https://github.com/NVIDIA/cuda-quantum/issues
+[github_repo]: https://github.com/NVIDIA/cuda-quantum

cudaq-0.9.0/README.md

@@ -0,0 +1,141 @@
+# Welcome to the CUDA-Q Python API
+
+CUDA-Q is a comprehensive framework for quantum programming. It features:
+
+- A programming model which extends C++ and Python with quantum kernels,
+  enabling high-level programming in familiar languages
+- A high-performance quantum compiler, `nvq++`, based on the industry standard
+  LLVM toolchain
+- Interoperability with all of the leading models and tools for accelerated
+  computing, including CUDA, ISO standard parallelism, OpenMP, and OpenACC
+- The ability to utilize and seamlessly switch between different quantum
+  technologies, including state-of-the-art simulator backends with NVIDIA
+  cuQuantum and a number of different physical quantum processors (QPUs)
+
+The CUDA-Q Python wheels contain the Python API and core components of CUDA-Q.
+This package installs CUDA-Q binaries that are compatible with a CUDA version
+11.x (where x >= 8) or 12.x. More information about available packages as
+well as a link to the documentation and examples for each version can be found
+in the [release notes][cudaq_docs_releases]. System and compatibility
+requirements are listed in the Installation Guide of the linked documentation.
+
+**Note**: CUDA-Q is currently only supported on Linux operating systems using
+`x86_64` or `aarch64`/`arm64` processors.
+
+[cudaq_docs_releases]:
+    https://nvidia.github.io/cuda-quantum/latest/releases.html
+
+## Installation Including GPU-Acceleration
+
+[//]: # (Begin complete install)
+
+CUDA-Q does not require a GPU to use, but some components are GPU-accelerated.
+
+Getting started with CUDA-Q on `x86_64` platforms simply requires `pip install
+cudaq`. Please make sure your `pip` version is \>= 24.0.
+If you have an NVIDIA GPU on your host system, you will be
+able to use it without any further installation steps.
+
+> **Important:** 
+> Please check if you have an existing installation of the `cuda-quantum`, `cudaq-quantum-cu11`, or `cuda-quantum-cu12` package, and uninstall it prior to installation. Different CUDA-Q binary distributions may conflict with each other causing issues.
+
+
+If you want to perform multi-GPU simulations, or if you are using
+`aarch64`/`arm64` processors, additional components must be installed. We
+recommend using [Conda](https://docs.conda.io/en/latest/) to do so. If you are
+not already using Conda, you can install a minimal version following the
+instructions [here](https://docs.anaconda.com/miniconda/). The following
+commands will create and activate a complete environment for CUDA-Q with all its
+dependencies:
+
+[//]: # (Begin conda install)
+
+```console
+cuda_version=11.8.0 # set this variable to version 11.x (where x >= 8) or 12.x
+conda create -y -n cudaq-env python=3.11 pip
+conda install -y -n cudaq-env -c "nvidia/label/cuda-${cuda_version}" cuda
+conda install -y -n cudaq-env -c conda-forge mpi4py openmpi cxx-compiler
+conda env config vars set -n cudaq-env LD_LIBRARY_PATH="$CONDA_PREFIX/envs/cudaq-env/lib:$LD_LIBRARY_PATH"
+conda env config vars set -n cudaq-env MPI_PATH=$CONDA_PREFIX/envs/cudaq-env
+conda activate cudaq-env
+pip install cudaq
+source $CONDA_PREFIX/lib/python3.11/site-packages/distributed_interfaces/activate_custom_mpi.sh
+```
+
+[//]: # (End conda install)
+
+You must configure MPI by setting the following environment variables:
+
+[//]: # (Begin ompi setup)
+
+```console
+export OMPI_MCA_opal_cuda_support=true OMPI_MCA_btl='^openib'
+```
+
+[//]: # (End ompi setup)
+
+*If you do not set these variables you may encounter a segmentation fault.*
+
+**Important**: It is *not* sufficient to set these variable within the Conda
+environment, like the commands above do for `LD_LIBRARY_PATH`. To avoid having
+to set them every time you launch a new shell, we recommend adding them to
+`~/.profile` (create the file if it does not exist), and to `~/.bash_profile` or
+`~/.bash_login` if such a file exists.
+
+[//]: # (End complete install)
+
+MPI uses [SSH](https://en.wikipedia.org/wiki/Secure_Shell) or
+[RSH](https://en.wikipedia.org/wiki/Remote_Shell) to communicate with each node
+unless another resource manager, such as
+[SLURM](https://slurm.schedmd.com/overview.html), is used. If you are
+encountering an error "The value of the MCA parameter `plm_rsh_agent` was set to
+a path that could not be found", please make sure you have an SSH Client
+installed.
+
+## Running CUDA-Q
+
+You should now be able to import CUDA-Q and start building quantum programs in
+Python!
+
+```console
+import cudaq
+
+kernel = cudaq.make_kernel()
+qubit = kernel.qalloc()
+kernel.x(qubit)
+kernel.mz(qubit)
+
+result = cudaq.sample(kernel)
+```
+
+Additional examples and documentation are linked in the [release
+notes][cudaq_docs_releases].
+
+## Contributing
+
+There are many ways in which you can get involved with CUDA-Q. If you are
+interested in developing quantum applications with CUDA-Q, our [GitHub
+repository][github_link] is a great place to get started! For more information
+about contributing to the CUDA-Q platform, please take a look at
+[Contributing.md](https://github.com/NVIDIA/cuda-quantum/blob/main/Contributing.md).
+
+## License
+
+CUDA-Q is an open source project. The source code is available on
+[GitHub][github_link] and licensed under [Apache License
+2.0](https://github.com/NVIDIA/cuda-quantum/blob/main/LICENSE). CUDA-Q makes use
+of the NVIDIA cuQuantum SDK to enable high-performance simulation, which is held
+to its own respective license.
+
+[github_link]: https://github.com/NVIDIA/cuda-quantum/
+
+## Feedback
+
+Please let us know your feedback and ideas for the CUDA-Q platform in the
+[Discussions][discussions] tab of our [GitHub repository][github_repo], or [file
+an issue][cuda_quantum_issues]. To report security concerns please reach out to
+[cuda-quantum@nvidia.com](mailto:cuda-quantum@nvidia.com).
+
+[discussions]: https://github.com/NVIDIA/cuda-quantum/discussions
+[cuda_quantum_issues]: https://github.com/NVIDIA/cuda-quantum/issues
+[github_repo]: https://github.com/NVIDIA/cuda-quantum

cudaq-0.9.0/_version.txt

@@ -0,0 +1 @@
+0.9.0

cudaq-0.9.0/cudaq.egg-info/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.1
+Name: cudaq
+Version: 0.9.0
+Summary: Python bindings for the CUDA-Q toolkit for heterogeneous quantum-classical workflows.
+Author: NVIDIA Corporation & Affiliates
+Maintainer: NVIDIA Corporation & Affiliates
+License: Apache License Version 2.0
+        
+        Copyright (c) 2023 - 2024 NVIDIA Corporation & Affiliates
+        All rights reserved.
+        
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+            http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+Project-URL: Homepage, https://developer.nvidia.com/cuda-q
+Project-URL: Documentation, https://nvidia.github.io/cuda-quantum
+Project-URL: Repository, https://github.com/NVIDIA/cuda-quantum
+Project-URL: Releases, https://nvidia.github.io/cuda-quantum/latest/releases.html
+Keywords: cudaq,cuda-quantum,cuda,quantum,quantum computing,nvidia,high-performance computing
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: GPU :: NVIDIA CUDA
+Classifier: Environment :: GPU :: NVIDIA CUDA :: 11
+Classifier: Environment :: GPU :: NVIDIA CUDA :: 12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: CITATION.cff
+Provides-Extra: chemistry
+Requires-Dist: scipy==1.10.1; extra == "chemistry"
+Requires-Dist: openfermionpyscf==0.5; extra == "chemistry"
+Requires-Dist: h5py<3.11; extra == "chemistry"
+Provides-Extra: visualization
+Requires-Dist: qutip<5; extra == "visualization"
+Requires-Dist: matplotlib>=3.5; extra == "visualization"
+
+# Welcome to the CUDA-Q Python API
+
+CUDA-Q is a comprehensive framework for quantum programming. It features:
+
+- A programming model which extends C++ and Python with quantum kernels,
+  enabling high-level programming in familiar languages
+- A high-performance quantum compiler, `nvq++`, based on the industry standard
+  LLVM toolchain
+- Interoperability with all of the leading models and tools for accelerated
+  computing, including CUDA, ISO standard parallelism, OpenMP, and OpenACC
+- The ability to utilize and seamlessly switch between different quantum
+  technologies, including state-of-the-art simulator backends with NVIDIA
+  cuQuantum and a number of different physical quantum processors (QPUs)
+
+The CUDA-Q Python wheels contain the Python API and core components of CUDA-Q.
+This package installs CUDA-Q binaries that are compatible with a CUDA version
+11.x (where x >= 8) or 12.x. More information about available packages as
+well as a link to the documentation and examples for each version can be found
+in the [release notes][cudaq_docs_releases]. System and compatibility
+requirements are listed in the Installation Guide of the linked documentation.
+
+**Note**: CUDA-Q is currently only supported on Linux operating systems using
+`x86_64` or `aarch64`/`arm64` processors.
+
+[cudaq_docs_releases]:
+    https://nvidia.github.io/cuda-quantum/latest/releases.html
+
+## Installation Including GPU-Acceleration
+
+[//]: # (Begin complete install)
+
+CUDA-Q does not require a GPU to use, but some components are GPU-accelerated.
+
+Getting started with CUDA-Q on `x86_64` platforms simply requires `pip install
+cudaq`. Please make sure your `pip` version is \>= 24.0.
+If you have an NVIDIA GPU on your host system, you will be
+able to use it without any further installation steps.
+
+> **Important:** 
+> Please check if you have an existing installation of the `cuda-quantum`, `cudaq-quantum-cu11`, or `cuda-quantum-cu12` package, and uninstall it prior to installation. Different CUDA-Q binary distributions may conflict with each other causing issues.
+
+
+If you want to perform multi-GPU simulations, or if you are using
+`aarch64`/`arm64` processors, additional components must be installed. We
+recommend using [Conda](https://docs.conda.io/en/latest/) to do so. If you are
+not already using Conda, you can install a minimal version following the
+instructions [here](https://docs.anaconda.com/miniconda/). The following
+commands will create and activate a complete environment for CUDA-Q with all its
+dependencies:
+
+[//]: # (Begin conda install)
+
+```console
+cuda_version=11.8.0 # set this variable to version 11.x (where x >= 8) or 12.x
+conda create -y -n cudaq-env python=3.11 pip
+conda install -y -n cudaq-env -c "nvidia/label/cuda-${cuda_version}" cuda
+conda install -y -n cudaq-env -c conda-forge mpi4py openmpi cxx-compiler
+conda env config vars set -n cudaq-env LD_LIBRARY_PATH="$CONDA_PREFIX/envs/cudaq-env/lib:$LD_LIBRARY_PATH"
+conda env config vars set -n cudaq-env MPI_PATH=$CONDA_PREFIX/envs/cudaq-env
+conda activate cudaq-env
+pip install cudaq
+source $CONDA_PREFIX/lib/python3.11/site-packages/distributed_interfaces/activate_custom_mpi.sh
+```
+
+[//]: # (End conda install)
+
+You must configure MPI by setting the following environment variables:
+
+[//]: # (Begin ompi setup)
+
+```console
+export OMPI_MCA_opal_cuda_support=true OMPI_MCA_btl='^openib'
+```
+
+[//]: # (End ompi setup)
+
+*If you do not set these variables you may encounter a segmentation fault.*
+
+**Important**: It is *not* sufficient to set these variable within the Conda
+environment, like the commands above do for `LD_LIBRARY_PATH`. To avoid having
+to set them every time you launch a new shell, we recommend adding them to
+`~/.profile` (create the file if it does not exist), and to `~/.bash_profile` or
+`~/.bash_login` if such a file exists.
+
+[//]: # (End complete install)
+
+MPI uses [SSH](https://en.wikipedia.org/wiki/Secure_Shell) or
+[RSH](https://en.wikipedia.org/wiki/Remote_Shell) to communicate with each node
+unless another resource manager, such as
+[SLURM](https://slurm.schedmd.com/overview.html), is used. If you are
+encountering an error "The value of the MCA parameter `plm_rsh_agent` was set to
+a path that could not be found", please make sure you have an SSH Client
+installed.
+
+## Running CUDA-Q
+
+You should now be able to import CUDA-Q and start building quantum programs in
+Python!
+
+```console
+import cudaq
+
+kernel = cudaq.make_kernel()
+qubit = kernel.qalloc()
+kernel.x(qubit)
+kernel.mz(qubit)
+
+result = cudaq.sample(kernel)
+```
+
+Additional examples and documentation are linked in the [release
+notes][cudaq_docs_releases].
+
+## Contributing
+
+There are many ways in which you can get involved with CUDA-Q. If you are
+interested in developing quantum applications with CUDA-Q, our [GitHub
+repository][github_link] is a great place to get started! For more information
+about contributing to the CUDA-Q platform, please take a look at
+[Contributing.md](https://github.com/NVIDIA/cuda-quantum/blob/main/Contributing.md).
+
+## License
+
+CUDA-Q is an open source project. The source code is available on
+[GitHub][github_link] and licensed under [Apache License
+2.0](https://github.com/NVIDIA/cuda-quantum/blob/main/LICENSE). CUDA-Q makes use
+of the NVIDIA cuQuantum SDK to enable high-performance simulation, which is held
+to its own respective license.
+
+[github_link]: https://github.com/NVIDIA/cuda-quantum/
+
+## Feedback
+
+Please let us know your feedback and ideas for the CUDA-Q platform in the
+[Discussions][discussions] tab of our [GitHub repository][github_repo], or [file
+an issue][cuda_quantum_issues]. To report security concerns please reach out to
+[cuda-quantum@nvidia.com](mailto:cuda-quantum@nvidia.com).
+
+[discussions]: https://github.com/NVIDIA/cuda-quantum/discussions
+[cuda_quantum_issues]: https://github.com/NVIDIA/cuda-quantum/issues
+[github_repo]: https://github.com/NVIDIA/cuda-quantum

cudaq-0.9.0/cudaq.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+CITATION.cff
+LICENSE
+NOTICE
+README.md
+_version.txt
+pyproject.toml
+setup.py
+cudaq.egg-info/PKG-INFO
+cudaq.egg-info/SOURCES.txt
+cudaq.egg-info/dependency_links.txt
+cudaq.egg-info/not-zip-safe
+cudaq.egg-info/requires.txt
+cudaq.egg-info/top_level.txt

cudaq-0.9.0/cudaq.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cudaq-0.9.0/cudaq.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

cudaq-0.9.0/cudaq.egg-info/requires.txt

@@ -0,0 +1,9 @@
+
+[chemistry]
+scipy==1.10.1
+openfermionpyscf==0.5
+h5py<3.11
+
+[visualization]
+qutip<5
+matplotlib>=3.5

cudaq-0.9.0/cudaq.egg-info/top_level.txt

@@ -0,0 +1 @@
+

cudaq-0.9.0/pyproject.toml

@@ -0,0 +1,57 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+[project]
+name = "cudaq"
+dynamic = ["version", "dependencies"]
+keywords = [ "cudaq", "cuda-quantum", "cuda", "quantum", "quantum computing", "nvidia", "high-performance computing" ]
+description="Python bindings for the CUDA-Q toolkit for heterogeneous quantum-classical workflows."
+authors = [{name = "NVIDIA Corporation & Affiliates"}]
+maintainers = [{name = "NVIDIA Corporation & Affiliates"}]
+readme = { file="README.md", content-type = "text/markdown"}
+requires-python = ">=3.10"
+license = { file="LICENSE" }
+classifiers = [
+    'Intended Audience :: Science/Research',
+    'Intended Audience :: Developers',
+    'Programming Language :: Python',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    "Environment :: GPU :: NVIDIA CUDA",
+    "Environment :: GPU :: NVIDIA CUDA :: 11",
+    "Environment :: GPU :: NVIDIA CUDA :: 12",
+    'Topic :: Software Development',
+    'Topic :: Scientific/Engineering',
+]
+
+[project.urls]
+Homepage = "https://developer.nvidia.com/cuda-q"
+Documentation = "https://nvidia.github.io/cuda-quantum"
+Repository = "https://github.com/NVIDIA/cuda-quantum"
+Releases = "https://nvidia.github.io/cuda-quantum/latest/releases.html"
+
+# We must use h5py<3.11 because 3.11 doesn't include aarch64 Linux wheels.
+# https://github.com/h5py/h5py/issues/2408
+[project.optional-dependencies]
+chemistry = [ "scipy==1.10.1", "openfermionpyscf==0.5", "h5py<3.11"  ]
+visualization = [ "qutip<5" , "matplotlib>=3.5" ]
+
+[build-system]
+requires = ["setuptools", "nvidia-ml-py"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = []
+include-package-data = true
+license-files = [ "LICENSE", "NOTICE", "CITATION.cff" ]
+
+[tool.setuptools.dynamic]
+version = {file = "_version.txt"}
+

cudaq-0.9.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cudaq-0.9.0/setup.py

@@ -0,0 +1,195 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+import ctypes, os, sys
+import importlib.util
+from setuptools import setup
+from typing import Optional
+
+
+def _log(msg: str) -> None:
+    sys.stdout.write(f'[cudaq] {msg}\n')
+    sys.stdout.flush()
+
+
+def _get_version_from_library(
+    libnames: list[str],
+    funcname: str,
+    nvrtc: bool = False,
+) -> Optional[int]:
+    """Returns the library version from list of candidate libraries."""
+
+    for libname in libnames:
+        try:
+            _log(f'Looking for library: {libname}')
+            runtime_so = ctypes.CDLL(libname)
+            break
+        except Exception as e:
+            _log(f'Failed to open {libname}: {e}')
+    else:
+        _log('No more candidate library to find')
+        return None
+
+    func = getattr(runtime_so, funcname, None)
+    if func is None:
+        raise Exception(f'{libname}: {func} could not be found')
+    func.restype = ctypes.c_int
+
+    if nvrtc:
+        func.argtypes = [
+            ctypes.POINTER(ctypes.c_int),
+            ctypes.POINTER(ctypes.c_int),
+        ]
+        major = ctypes.c_int()
+        minor = ctypes.c_int()
+        retval = func(major, minor)
+        version = major.value * 1000 + minor.value * 10
+    else:
+        func.argtypes = [
+            ctypes.POINTER(ctypes.c_int),
+        ]
+        version_ref = ctypes.c_int()
+        retval = func(version_ref)
+        version = version_ref.value
+
+    if retval != 0:
+        raise Exception(f'{libname}: {func} returned error: {retval}')
+    _log(f'Detected version: {version}')
+    return version
+
+
+def _get_cuda_version() -> Optional[int]:
+    """Returns the detected CUDA version or None."""
+
+    version = None
+
+    # Try to detect version from NVRTC
+    libnames = [
+        'libnvrtc.so.12',
+        'libnvrtc.so.11.2',
+        'libnvrtc.so.11.1',
+        'libnvrtc.so.11.0',
+    ]
+    _log(f'Trying to detect CUDA version from libraries: {libnames}')
+    try:
+        version = _get_version_from_library(libnames, 'nvrtcVersion', True)
+    except Exception as e:
+        _log(f"Error: {e}")  # log and move on
+    if version is not None:
+        _log("Autodetection succeeded")
+        return version
+
+    # Try to detect version from CUDART (a CUDA context will be initialized)
+    libnames = [
+        'libcudart.so.12',
+        'libcudart.so.11.0',
+    ]
+    _log(f'Trying to detect CUDA version from libraries: {libnames}')
+    try:
+        version = _get_version_from_library(libnames, 'cudaRuntimeGetVersion',
+                                            False)
+    except Exception as e:
+        _log(f"Error: {e}")  # log and move on
+    if version is not None:
+        _log("Autodetection succeeded")
+        return version
+
+    # Try to get version from NVIDIA Management Library
+    try:
+        _log(f'Trying to detect CUDA version using NVIDIA Management Library')
+        from pynvml import nvmlInit, nvmlSystemGetCudaDriverVersion
+        nvmlInit()
+        version = nvmlSystemGetCudaDriverVersion()
+    except Exception as e:
+        _log(f"Error: {e}")  # log and move on
+    if version is not None:
+        _log(f'Detected version: {version}')
+        _log("Autodetection succeeded")
+        return version
+
+    _log("Autodetection failed")
+    return None
+
+
+def _infer_best_package() -> str:
+
+    # Find the existing wheel installation
+    installed = []
+    for pkg_suffix in ['', '-cu11', '-cu12']:
+        _log(f"Looking for existing installation of cuda-quantum{pkg_suffix}.")
+        try:
+            package_spec = importlib.util.find_spec(f"cuda-quantum{pkg_suffix}")
+            if package_spec is None:
+                _log("No installation found.")
+            else:
+                installed.append(f"cuda-quantum{pkg_suffix}")
+                _log("Installation found.")
+        except:
+            _log("No installation found.")
+            pass
+
+    cuda_version = _get_cuda_version()
+    if cuda_version is None:
+        cudaq_bdist = 'cuda-quantum-cu12'
+    elif cuda_version < 11000:
+        raise Exception(f'Your CUDA version ({cuda_version}) is too old.')
+    elif cuda_version < 12000:
+        cudaq_bdist = 'cuda-quantum-cu11'
+    elif cuda_version < 13000:
+        cudaq_bdist = 'cuda-quantum-cu12'
+    else:
+        raise Exception(f'Your CUDA version ({cuda_version}) is too new.')
+    _log(f"Identified {cudaq_bdist} as the best package.")
+
+    # Disallow -cu11 & -cu12 wheels from coexisting
+    conflicting = ", ".join((pkg for pkg in installed if pkg != cudaq_bdist))
+    _log(f"Conflicting packages: {conflicting}")
+    if conflicting != '':
+        _log("Abort.")
+        raise Exception(
+            f'You have a conflicting CUDA-Q version installed.'
+            f'Please remove the following package(s): {conflicting}')
+    return cudaq_bdist
+
+
+# This setup handles 3 cases:
+#   1. At the release time, we use it to generate source distribution (which contains
+#      this script).
+#   2. If the source distribution is generated for the deprecated cuda-quantum package
+#      name, this script raises an exception at install time asking to install cudaq.
+#   3. If the source distribution is generated for a valid cudaq version,
+#      this script identifies the installed CUDA version at cudaq install time
+#      and downloads the corresponding CUDA-Q binary distribution.
+# For case 1, `CUDAQ_META_WHEEL_BUILD` is set to 1.
+setup_dir = os.path.dirname(os.path.abspath(__file__))
+data_files = []
+install_requires = []
+if os.environ.get('CUDAQ_META_WHEEL_BUILD', '0') == '1':
+    # Case 1: create source distribution
+    if os.path.exists(os.path.join(setup_dir, "_deprecated.txt")):
+        data_files = [('', [
+            '_deprecated.txt',
+        ])]  # extra files to be copied into the distribution
+else:
+    # Case 2: install cuda-quantum source distribution
+    if os.path.exists(os.path.join(setup_dir, "_deprecated.txt")):
+        with open(os.path.join(setup_dir, "_deprecated.txt"), "r") as f:
+            deprecation = f.read()
+        raise Exception(f'This package is deprecated. \n' + deprecation)
+    # Case 3: install cudaq source distribution
+    with open(os.path.join(setup_dir, "_version.txt"), "r") as f:
+        __version__ = f.read()
+    install_requires = [
+        f"{_infer_best_package()}=={__version__}",
+    ]
+
+setup(
+    zip_safe=False,
+    data_files=data_files,
+    install_requires=install_requires,
+)