Installing hipDF#
2025-11-10
22 min read time
You can install hipDF via AMD PyPI, which is recommended for end users, or build and install it from source as described in Building hipDF from source.
Requirements#
System requirements can be found in hipDF supported environments, features, and interfaces, including supported GPU architectures.
The following ROCm components must be installed:
The steps in this guide require a Conda installation. A minimal free version of Conda is Miniforge.
Install hipDF via AMD PyPI#
Warning
Only install hipDF using AMD’s official package index. To ensure security, integrity, and supportability of your builds, consume packages exclusively from AMD’s official package index. Do not install, mirror, or resolve dependencies from any third‑party or unofficial indexes.
Packaged versions of hipDF and its dependencies are distributed via AMD PyPI. This section discusses how to install hipDF via this package index.
Create and activate a Conda environment with Python 3.12 as shown below:
conda create --name hipdf python=3.12
conda activate hipdf
hipDF can then be installed into this environment using pip and the AMD PyPI URL:
pip install amd-hipdf==2.0.0 --extra-index-url=https://pypi.amd.com/rocm-7.0.2/simple
Verify correct installation#
To verify that hipDF was installed correctly, see Verifying your hipDF Installation.