Skip to content

Kraftverk 0.2.1 — AMD-Exclusive Hardware Enforcement

Choose a tag to compare

@theworker02 theworker02 released this 11 Aug 23:20
· 26 commits to main since this release

Highlights

Kraftverk 0.2.1 adds hard AMD-exclusive hardware enforcement (amd-only-v1) across CLI, desktop, SDK, agent, and optimizer — plus Windows GPU ClassGUID detection polish. Builds on the 0.2.0 platform phase (KraftBench v2, optimizer sessions/profiles, desktop instrument, SDK).

Independent product: not affiliated with or endorsed by AMD.

What's included

  • CLI (kraftverk / kraftverk.exe) — inspect, baseline, optimize, report, profiles, doctor, and more
  • Desktop (kraftverk-desktop / kraftverk-desktop.exe) — local web UI + hardware blocker
  • AMD gate — CPUID + PCI vendor checks; policy amd-only-v1 on experiments/fingerprints
  • Inspect-only commandscompatibility, hardware, amd cpu|gpu (no eligibility gate)
  • Exit codes 20–25 for unsupported architecture / Intel CPU / NVIDIA GPU / Intel GPU / unknown / mixed
  • Hot-plug NVIDIA abort — stop experiments, restore managed config, block further work
  • KraftBench v2 — CPU scaling, compile proxy, responsiveness, sustained windows
  • Optimizer — goals, constraints, sessions/resume, lineage, insights, evidence receipts
  • SDKKraftverk::open_default() fails with UnsupportedHardware on ineligible hosts
  • Packaged archives include README.md, LICENSE, and CHANGELOG.md

Install

Windows (x86_64)

  1. Download kraftverk-v0.2.1-x86_64-pc-windows-msvc.zip

  2. Verify checksum against kraftverk-v0.2.1-x86_64-pc-windows-msvc.zip.sha256:

    Get-FileHash .\kraftverk-v0.2.1-x86_64-pc-windows-msvc.zip -Algorithm SHA256
    Get-Content .\kraftverk-v0.2.1-x86_64-pc-windows-msvc.zip.sha256
  3. Extract the zip. Run CLI or desktop from the extracted folder:

    .\kraftverk.exe compatibility
    .\kraftverk-desktop.exe

    Loose binaries (kraftverk.exe, kraftverk-desktop.exe) are also attached to this release if you prefer not to use the archive.

Linux (x86_64)

  1. Download kraftverk-v0.2.1-x86_64-unknown-linux-gnu.tar.gz

  2. Verify checksum against kraftverk-v0.2.1-x86_64-unknown-linux-gnu.tar.gz.sha256:

    sha256sum -c kraftverk-v0.2.1-x86_64-unknown-linux-gnu.tar.gz.sha256
  3. Extract and run:

    tar xzf kraftverk-v0.2.1-x86_64-unknown-linux-gnu.tar.gz
    cd kraftverk-v0.2.1-x86_64-unknown-linux-gnu
    chmod +x kraftverk kraftverk-desktop
    ./kraftverk compatibility
    ./kraftverk-desktop

Build from source

cargo build --release -p kraftverk-cli
cargo build --release -p kraftverk-desktop

Quick start

kraftverk compatibility
kraftverk hardware
kraftverk inspect
kraftverk baseline
kraftverk optimize --mode safe --goal balanced
kraftverk status
kraftverk report --format html
kraftverk restore --baseline

Desktop (same local DB):

kraftverk-desktop

Hardware requirements

Check Rule
Architecture x86 / x86_64 only
CPU AMD (AuthenticAMD)
GPU None OK; if present, AMD only (PCI 0x1002)
Blocked Intel CPU; NVIDIA / Intel GPU; mixed / unknown vendors

Exit codes 20–25. No production --force bypass.

Full policy: Hardware support · docs/hardware-support.md

License

Proprietary — All Rights Reserved. Copyright © 2026 theworker02.

You may view and run the software as published. Modification and redistribution of modified versions require prior written permission. See LICENSE (also bundled in each archive).

Documentation

Known limitations

  • GPU benchmarks unsupported (no vendor backend)
  • Temperature / power sensors unavailable portably
  • Privileged agent remains a scaffold
  • Desktop is a local web UI (Tauri packaging later)
  • ε-greedy / Bayesian search plugins listed but not implemented

Checksums

Per-archive SHA-256 sidecar files are attached:

  • kraftverk-v0.2.1-x86_64-pc-windows-msvc.zip.sha256
  • kraftverk-v0.2.1-x86_64-unknown-linux-gnu.tar.gz.sha256

Compare the hash of the downloaded archive to the contents of the matching .sha256 asset before running binaries.

Full Changelog: v0.2.0...v0.2.1