kernelguard

library0.2.2pypypiunverified

KernelGuard is a rule-based GPU kernel hack detector for Python. It scans CUDA and HIP kernel source for suspicious patterns indicative of potential exploits or malicious modifications. Version 0.2.2 is current, with weekly releases.

ai-ml

pip install kernelguard

package ↗

INSTALL

IMPORT

SIG · KERNELGUARD

kernelguard

ai-mlpythonv0.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

KernelScanner

✓ from kernelguard_api import KernelScanner

✗ from kernelguard import KernelScanner

Basic scan with custom rule.

from kernelguard import KernelScanner, Rule import os scanner = KernelScanner() rule = Rule( name="check_unsafe_memcpy", pattern=r"cudaMemcpy\s*\(", severity="high", message="Direct cudaMemcpy call detected" ) scanner.add_rule(rule) source_code = """ __global__ void kernel() { cudaMemcpy(dest, src, size, cudaMemcpyDeviceToHost); } """ results = scanner.scan(source_code) for r in results: print(r)

Debug

Known issues

gotchaKernelScanner.scan() expects a string, not a file path — use open().read() first.

fix

with open('kernel.cu') as f: source = f.read()

affects: >=0.1.0

deprecatedThe 'rules' parameter in KernelScanner constructor is deprecated in 0.2.0; use add_rule() instead.

fix

scanner = KernelScanner(); scanner.add_rule(rule)

affects: >=0.2.0

breakingRule severity enum values changed in 0.2.0 from strings ('low', 'medium', 'high') to enum members (RuleSeverity.LOW etc.).

fix

from kernelguard import RuleSeverity; rule = Rule(..., severity=RuleSeverity.HIGH)

affects: >=0.2.0

gotchaPatterns must be raw strings or escaped properly — backslashes are Python string escapes.

fix

Use r"pattern" instead of "pattern".

affects: >=0.1.0

Upgrade

Version history

0.2.2latest on PyPI · released Apr 6, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/kernelguard/ ↗