Skip to content

Your GeForce runs AI at half speed. This fixes it for 20/30/40 series cards. Up to 2× FP16 / BF16 / TF32 tensor throughput

C

Add issue forms for compatibility reports and bugs

Claude285f167d2345
diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
new file mode 100644
index 0000000..1fafcfd
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -0,0 +1,56 @@
+name: Bug report
+description: Something wrong with building, installing, packaging or boot ordering. For how a card behaved, use a compatibility report.
+body:
+ - type: textarea
+ id: what
+ attributes:
+ label: What happened
+ description: What you did, what you expected, and what happened instead.
+ validations:
+ required: true
+
+ - type: input
+ id: distro
+ attributes:
+ label: Distribution
+ placeholder: Ubuntu 24.04, Arch, Fedora 44 ...
+ validations:
+ required: true
+
+ - type: input
+ id: kernel
+ attributes:
+ label: Kernel
+ description: Output of `uname -r`
+ validations:
+ required: true
+
+ - type: dropdown
+ id: initramfs
+ attributes:
+ label: Initramfs generator
+ options:
+ - mkinitcpio
+ - dracut
+ - initramfs-tools
+ - Other or not sure
+ validations:
+ required: true
+
+ - type: input
+ id: version
+ attributes:
+ label: gpu-unlock version and install method
+ description: Commit from `git rev-parse --short HEAD` in your checkout, and how you installed it.
+ placeholder: 4189b17, make install-arch
+ validations:
+ required: true
+
+ - type: textarea
+ id: output
+ attributes:
+ label: Output
+ description: The failing command's output, and `journalctl -k -b | grep -i gpu_unlock` if the problem is at boot.
+ render: text
+ validations:
+ required: false
diff --git a/.github/ISSUE_TEMPLATE/compatibility-report.yml b/.github/ISSUE_TEMPLATE/compatibility-report.yml
new file mode 100644
index 0000000..949b5c1
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/compatibility-report.yml
@@ -0,0 +1,171 @@
+name: Compatibility report
+description: Report how gpu_unlock worked on your card, whether it unlocked or not.
+title: "Compatibility report: <card> (<PCI ID>)"
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for testing. Reports from as many cards, boards and distributions as possible are what tell us what works.
+ Please paste command output as-is.
+
+ - type: dropdown
+ id: result
+ attributes:
+ label: Result
+ options:
+ - Unlocked, and FP16/BF16 got faster
+ - Unlock completed, but no speedup
+ - Unlock failed (error in the log)
+ - gpu_unlock never ran (no gpu_unlock lines in the log)
+ validations:
+ required: true
+
+ - type: input
+ id: card
+ attributes:
+ label: Card
+ description: Brand, model and memory size.
+ placeholder: EVGA RTX 3090 FTW3 24 GB
+ validations:
+ required: true
+
+ - type: textarea
+ id: lspci
+ attributes:
+ label: PCI IDs
+ description: Output of `lspci -nn -D -d 10de:`
+ render: text
+ validations:
+ required: true
+
+ - type: input
+ id: vbios
+ attributes:
+ label: VBIOS version
+ description: Output of `nvidia-smi --query-gpu=pci.bus_id,vbios_version --format=csv,noheader`
+ placeholder: 00000000:01:00.0, 94.02.42.C0.05
+ validations:
+ required: true
+
+ - type: dropdown
+ id: modified
+ attributes:
+ label: Is the card modified?
+ options:
+ - Stock
+ - Memory upgrade (e.g. 3080 20 GB)
+ - Flashed with a different VBIOS
+ - OEM or other non-retail card
+ - Not sure
+ validations:
+ required: true
+
+ - type: input
+ id: distro
+ attributes:
+ label: Distribution
+ placeholder: Ubuntu 24.04, Arch, Fedora 44, Proxmox 9 ...
+ validations:
+ required: true
+
+ - type: input
+ id: kernel
+ attributes:
+ label: Kernel
+ description: Output of `uname -r`
+ validations:
+ required: true
+
+ - type: input
+ id: driver
+ attributes:
+ label: NVIDIA driver
+ description: Version and flavour, e.g. from `nvidia-smi --query-gpu=driver_version --format=csv,noheader`
+ placeholder: 610.57.04, open kernel modules
+ validations:
+ required: true
+
+ - type: dropdown
+ id: initramfs
+ attributes:
+ label: Initramfs generator
+ options:
+ - mkinitcpio
+ - dracut
+ - initramfs-tools
+ - Other or not sure
+ validations:
+ required: true
+
+ - type: input
+ id: version
+ attributes:
+ label: gpu-unlock version and install method
+ description: Commit from `git rev-parse --short HEAD` in your checkout, and how you installed it.
+ placeholder: 4189b17, make install-deb
+ validations:
+ required: true
+
+ - type: input
+ id: cmdline
+ attributes:
+ label: Kernel command line
+ description: Output of `cat /proc/cmdline`
+ validations:
+ required: true
+
+ - type: textarea
+ id: setup
+ attributes:
+ label: Setup
+ description: Anything that makes your system unusual, for example several GPUs, display card or headless, VM passthrough, power limit, Secure Boot.
+ placeholder: |
+ 2x RTX 3090, headless, power limit 350 W
+ validations:
+ required: false
+
+ - type: textarea
+ id: log
+ attributes:
+ label: Kernel log
+ description: Output of `journalctl -k -b | grep -i gpu_unlock` from the boot you are reporting.
+ render: text
+ validations:
+ required: true
+
+ - type: textarea
+ id: benchmark
+ attributes:
+ label: Benchmark before and after
+ description: |
+ Optional, but very useful. Run the same benchmark at the same power limit with and without `gpu_unlock.targets=` on the kernel command line.
+ Say what you ran (tool, matrix size, accumulation type) and give TFLOPS for FP16, BF16 and TF32 if you can.
+ placeholder: |
+ torch 2.9 cuBLAS, 8192³ dense GEMM, FP32 accumulation, 350 W
+ | Input | Before | After |
+ | ----- | ------ | ----- |
+ | FP16 | | |
+ | BF16 | | |
+ | TF32 | | |
+ validations:
+ required: false
+
+ - type: dropdown
+ id: suspend
+ attributes:
+ label: Suspend and resume
+ description: Is the card still unlocked after suspend to RAM (`systemctl suspend`)?
+ options:
+ - Not tested
+ - Still unlocked after resume
+ - Not unlocked after resume
+ - The system does not resume
+ validations:
+ required: false
+
+ - type: textarea
+ id: notes
+ attributes:
+ label: Anything else
+ validations:
+ required: false