Kernels documentation
kernels check
You are viewing main version, which requires installation from source. If you'd like
regular pip install, checkout the latest stable version (v0.15.2).
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-checkExamples
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.0Options
| 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 |