#
kernels check

Use `kernels check` to verify that a kernel on the Hub meets compliance requirements.

##
What It Checks

- Python ABI compatibility (default: 3.9)
- Operating system compatibility (macOS 15.0+, manylinux_2_28)

##
Usage

    kernels check <repo_id> [--revision <rev>] [--macos <version>] [--manylinux <version>] [--python-abi <version>]

##
Installation

`kernels check` requires an additional dependency:

    uv pip install kernel-abi-check # or pip install kernel-abi-check

##
Examples

Check a kernel on the Hub:

    kernels check kernels-community/flash-attn3

Check a specific revision:

    kernels check kernels-community/flash-attn3 --revision v2

Check with custom compatibility requirements:

    kernels check kernels-community/flash-attn3 --python-abi 3.10 --manylinux manylinux_2_31

##
Example Output

    Checking variant: torch210-metal-aarch64-darwin
      Dynamic library _example_kernel_metal_2juixjwdznbhy.abi3.so:
        🐍 Python ABI 3.9 compatible
        🍏 compatible with macOS 15.0
    Checking variant: torch29-metal-aarch64-darwin
      Dynamic library _example_kernel_metal_vtlnpevkb6uum.abi3.so:
        🐍 Python ABI 3.9 compatible
        🍏 compatible with macOS 15.0

##
Options

Option | Default | Description
--- | --- | ---
`--revision` | `main` | Branch, tag, or commit SHA to check
`--macos` | `15.0` | Minimum macOS version to require
`--manylinux` | `manylinux_2_28` | Manylinux version to require
`--python-abi` | `3.9` | Python ABI version to require

Update on GitHub