Contributing

We welcome issues and pull requests on GitHub.

Getting started

git clone https://github.com/AMDResearch/intellikit.git
cd intellikit

Each tool is an independent Python package. Install the ones you want to work on in editable mode:

pip install -e ./metrix
pip install -e ./linex
pip install -e ./kerncap[dev]
# ...any subset

There is no metapackage at the monorepo root — install each package individually.

Running tests

Each package has its own test suite:

# Metrix
python3 -m pytest metrix/tests/ -v

# Kerncap unit tests (no GPU required)
PYTHONPATH=kerncap pytest kerncap/tests/unit/ -v

# Kerncap integration tests (requires ROCm + AMD GPU)
PYTHONPATH=kerncap pytest kerncap/tests/integration/ -v

Project structure

intellikit/
├── accordo/        Kernel validation
├── kerncap/        Kernel extraction and isolation
├── linex/          Source-line GPU profiling
├── metrix/         Human-readable GPU metrics
├── nexus/          HSA packet source extraction
├── rocm_mcp/       ROCm MCP servers
├── uprof_mcp/      AMD uProf MCP server
├── install/        Install scripts (tools + skills)
└── docs/           This documentation site

Bugs and ideas

• Issues: github.com/AMDResearch/intellikit/issues

License

MIT — Copyright 2025-2026 Advanced Micro Devices, Inc.