download · v1.1.0
Unpack it anywhere and run it. Everything knaif needs ships beside the binary — the model is fetched on first run and verified against a pinned hash.
all platforms
Requires Windows 10 or later
Inno installer, per-user, no admin required.
Unpack anywhere and run; everything it needs ships beside the binary.
Binaries are unsigned, so Windows SmartScreen shows "Windows protected your PC". Choose More info → Run anyway. Verify the checksum first.
Requires glibc 2.34+ and libstdc++ providing GLIBCXX_3.4.30 / CXXABI_1.3.13
chmod +x and run. Needs FUSE2 (libfuse2t64 on Ubuntu 24.04); otherwise run with --appimage-extract-and-run.
Tested on Ubuntu 22.04+, Debian 12+, Fedora 36+, Linux Mint 21+.
RHEL / Rocky / AlmaLinux 9 is not supported — glibc is new enough, but the shipped libstdc++ is one version short of GLIBCXX_3.4.30. Bundling libstdc++ was rejected: libggml-vulkan.so dlopens a host driver built against the system copy.
macOS — Core is cross-platform; packaging is a fast-follow. No artifact is published.
verify what you downloaded
The Windows binaries are unsigned, so the checksum — not the absence of a warning — is what tells you the file is intact. Every artifact is listed in one signed-by-GitHub manifest.
SHA256SUMS for v1.1.0# Windows (PowerShell)
Get-FileHash .\knaif-1.1.0-windows-x64-setup.exe -Algorithm SHA256
# Linux / macOS
sha256sum knaif-1.1.0-linux-x64.tar.gzgraphics
Every download includes CPU and Vulkan support, and auto-selects Vulkan when a capable driver is present.
On NVIDIA Blackwell cards (RTX 50xx) the Vulkan path runs at roughly CPU speed, so CUDA is what makes knaif usable there. On older NVIDIA cards it is faster and genuinely optional.
knaif backend install cuda · ~668 MB · needs NVIDIA driver R580 or newer
after you install
On first run knaif offers to download the recommended model (~2.5 GB) into ~/.knaif, verified against a pinned SHA-256. Upgrading knaif re-downloads nothing while the recommendation is unchanged.
Skills that use external programs (FFmpeg, LibreOffice, Ghostscript, Tesseract) need them installed separately. Run `knaif skills deps` to see what is missing.
$ knaif models pull
$ knaif run ffmpeg "make a thumbnail from the first frame of clip.mp4"
$ knaif run ffmpeg --dry-run "..." # print the command, don't run itknaif 1.1.0, published 2 August 2026. Older builds are on thereleases page.