Installing hipDF#
2026-07-06
20 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.
See System requirements for information regarding supported operating systems, ROCm versions, and AMD GPUs before installing hipDF.
Prerequisites#
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 a compatible Python version, such as 3.11 or 3.12 as shown below. For more information on compatible Python versions, see System requirements.
conda create --name hipdf python=3.12 #Specify your Python version
conda activate hipdf
hipDF can then be installed into this environment using pip and the AMD PyPI URL:
pip install amd-hipdf==3.0.0 --extra-index-url=https://pypi.amd.com/rocm-7.2.3/simple
Verify correct installation#
To verify that hipDF was installed correctly, see Verifying your hipDF Installation.