AIFX v0.2.1 (macOS + Windows + Linux)
Pre-releaseAll three platforms ship 0.2.1. The Windows artifacts were re-cut from the
v0.2.1 tag on 2026-08-26, so every published bundle — macOS, Windows, Linux —
now carries the 0.2.1 build stamp.
Fixed
Paths sent to a Linux/macOS ComfyUI server were unusable
The plugin rewrote every submitted path to backslashes, assuming the ComfyUI box
is always a Windows storage server. On a POSIX server a backslash is an ordinary
filename character, so every LoadEXR / SaveEXR node failed with
Path not found: \Volumes\silo2\....
The separator style now follows the ComfyUI Server Mount value itself — a UNC
path (\\host\share) or drive letter (Z:\share) yields backslashes, anything
else yields forward slashes. The OFX host and ComfyUI can now be the same Linux
machine, or reach each other across any OS pairing. Trailing separators on either
mount are stripped before splicing.
Added
Every artifact identifies itself
Bundles used to all claim version 1.0.0, so a plugin found on a workstation was
indistinguishable from any other build. That is how a pre-0.1.5 bundle survived
unnoticed in /Library/OFX/Plugins and kept segfaulting Flare on macOS long after
the fix had shipped. From this release every bundle carries its version in three
places:
cat "<bundle>.ofx.bundle/Contents/Resources/aifx-build.txt"
strings "<bundle>.ofx.bundle/Contents/MacOS/<name>.ofx" | grep AIFX-BUILDOn Windows, read the same stamp from the bundle's Contents\Resources\:
Get-Content "<bundle>.ofx.bundle\Contents\Resources\aifx-build.txt"tools/verify-ofx-abi.sh
Checks built or installed bundles and needs no build tree, so it runs on a
workstation. With no arguments it scans that OS's OFX plugin directories:
OK DepthAnything3 — 0.2.1 (v1-gl1-cl0-cu0, openfx 96ccd1a)
FAIL MatteMaMa — legacy build with a SHORT vtable (232B, expected >= 248B)
For bundles predating the stamp it measures the emitted ComfyUI::BasePlugin
vtable, which still identifies the known-bad pre-0.1.5 builds. If a host crashes
the instant you select an AIFX plugin, run this first — it is almost always a
stale bundle from an older install.
Compile-time OpenFX ABI guard
Every plugin translation unit now static_asserts that its view of the OpenFX
Support ABI matches the OfxSupport archive it links against. The vtable-slot
mismatch that caused the crash above is no longer buildable.
Note — artifacts rebuilt from the tag on 2026-08-26
The originally published .dmg contained an APFS volume (hdiutil's default
on a recent build host), which does not mount on macOS 10.12 or earlier — and
fails silently, so double-clicking it appears to do nothing. It is now HFS+,
which mounts on every macOS that can run an OFX host.
The Windows .zip and .exe were added the same day, built from the same tagged
source; every plugin binary in them reports version=0.2.1 (the release script
refuses to package a bundle whose stamp disagrees).
All artifacts now correspond exactly to the tagged source. The SHA-256 values
below are the current files.
Known issue — macOS blocks the installer
The .dmg is not yet signed with an Apple Developer ID, so macOS 15 (Sequoia)
refuses to launch it: "Apple could not verify 'AIFX Installer.app' is free of
malware". Neither right-click → Open nor the Open Anyway button is
offered for an unsigned app. Copy the app out of the read-only DMG and clear the
quarantine flag:
cp -R "/Volumes/AIFX 0.2.1/AIFX Installer.app" /Applications/
xattr -dr com.apple.quarantine "/Applications/AIFX Installer.app"
open "/Applications/AIFX Installer.app"The .tar.gz contains no app and is unaffected.
Known issue — Windows SmartScreen warns on the installer
aifx-0.2.1-windows-setup.exe is not code-signed, so SmartScreen shows "Windows
protected your PC" on first run. Click More info → Run anyway, or verify the
SHA-256 below and use the .zip instead (copy the seven .ofx.bundle folders to
C:\Program Files\Common Files\OFX\Plugins\).
Upgrading
Delete any AIFX bundles from an earlier install before running the installer —
it does not remove bundles from a different install location, and a stale bundle
left in /Library/OFX/Plugins will keep crashing the host. Then verify:
tools/verify-ofx-abi.sh(macOS/Linux. On Windows, check each installed bundle's
Contents\Resources\aifx-build.txt reads version=0.2.1.)
Full changelog: https://github.com/Dev-Reepost/aifx/blob/v0.2.1/CHANGELOG.md
SHA-256
4757109377a87414552b91a5e6bc8440e16a5e605af096ca511c865decfac67f aifx-0.2.1-linux-x86_64.tar.gz
957a4658e1de457dcfc8d4df21c6ed794cd8f2f91dc0569c4213974fd852608e aifx-0.2.1-macos-universal.tar.gz
c9abdcb7c6079b50e26fb089580a48acde0775084591deecd32762005b754eaf aifx-0.2.1-macos-installer.dmg
b8663abbbe799c93f366143a937d9a8820bb83f364a063c0b22391721a2d9f28 aifx-0.2.1-windows-x86_64.zip
ad28d6421b8af82d3c8b9a0211c04216acc4498fa145b31cfd3205340d9c45f3 aifx-0.2.1-windows-setup.exe