Skip to content

Installation

Quick install

Install all tools from Git via pip:

Terminal window
curl -sSL https://raw.githubusercontent.com/AMDResearch/intellikit/main/install/tools/install.sh | bash

Install agent skills (for Cursor, Claude, Codex):

Terminal window
curl -sSL https://raw.githubusercontent.com/AMDResearch/intellikit/main/install/skills/install.sh | bash

Requirements

RequirementNotes
Python3.10 or newer
ROCm6.0+ for GPU packages (7.0+ for Linex); skip if you only use host-side tools like uprof_mcp
GPUMI300+ for the full GPU experience; some tools vary — see each tool’s page
uProfAMD uProf on x86 for uprof_mcp only

Individual packages

Install a single package from Git:

Terminal window
pip install "git+https://github.com/AMDResearch/intellikit.git#subdirectory=metrix"
# Also: accordo, kerncap, linex, nexus, rocm_mcp, uprof_mcp

Editable install (development)

Terminal window
git clone https://github.com/AMDResearch/intellikit.git
cd intellikit
pip install -e ./metrix
pip install -e ./linex
# ...any subset

Install script options

Tools script (install/tools/install.sh)

  • Default pip3; the script checks that pip’s Python is 3.10+ before installing.
  • Subset only: --tools metrix,linex,nexus
  • Custom pip: --pip-cmd pip3.12 or --pip-cmd "python3.12 -m pip"
  • Branch/tag: --ref my-branch
  • Different repo: --repo-url https://github.com/you/fork.git
  • Preview: --dry-run

Pipe flags after bash -s --:

Terminal window
curl -sSL .../install/tools/install.sh | bash -s -- --tools metrix,linex

Skills script (install/skills/install.sh)

  • --target cursor | claude | codex | agents | github — where skills are written
  • --global — e.g. ~/.cursor/skills/ for Cursor
  • --dry-run