Skip to content
AMD AMD Radeon Cloud Docs

Install and upgrade

Radeon Cloud CLI is published on PyPI as amd-oneclick-sdk and provides the rcc command. It needs Python 3.9 or newer.

Install with pip

Section titled “Install with pip”

Linux and macOS:

Terminal window
python3 -m pip install amd-oneclick-sdk
rcc --version

Windows (PowerShell or Command Prompt):

Terminal window
python -m pip install amd-oneclick-sdk
rcc --version

If you have the Python Launcher, py works in place of python.

Install with pipx

Section titled “Install with pipx”

pipx installs the CLI in its own environment, away from your other Python packages:

Terminal window
pipx install amd-oneclick-sdk
rcc --version

When pip refuses: use a virtual environment

Section titled “When pip refuses: use a virtual environment”

Some systems do not allow installing into the system Python, and pip stops with externally-managed-environment. Use pipx, or create a virtual environment.

Linux and macOS:

Terminal window
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install amd-oneclick-sdk

Windows PowerShell:

Terminal window
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install amd-oneclick-sdk

Then check the installation:

Terminal window
rcc --version
rcc --help

Upgrade

Section titled “Upgrade”
Terminal window
python3 -m pip install --upgrade amd-oneclick-sdk   # installed with pip
pipx upgrade amd-oneclick-sdk                       # installed with pipx

Uninstall

Section titled “Uninstall”
Terminal window
python3 -m pip uninstall amd-oneclick-sdk

Uninstalling leaves ~/.radeon-cloud in place. It holds your saved accounts, their sign-in tokens and any SSH keys the CLI generated. To remove everything, first run rcc auth logout --all so the saved tokens stop working. Then make sure the directory holds no SSH private key you still need, and delete it.