Download

Pre-built packages are available from GitHub Releases.

Desktop app (GUI)

Platform File Notes
Windows x64 aicr-gui-win-x64.exe Runs directly — no installer needed
Linux x64 aicr-gui-x86_64.AppImage Run chmod +x on it first, then double-click or execute
Linux arm64 aicr-gui-aarch64.AppImage Same as above
macOS Apple Silicon aicr-gui-osx-arm64.dmg Open, drag to Applications; first launch: right-click → Open
macOS Intel aicr-gui-osx-x64.dmg Same as above

On Linux, the AppImage runs on any distro from the Ubuntu 18.04 era onward (glibc 2.27+) with libicu installed — every desktop distro ships it; only minimal/server images lack it (symptom: “Couldn’t find a valid ICU package” at startup). An AppImage runs in place and does not add itself to the app menu — for menu and dock integration, build from source with scripts/install-linux.sh or use an AppImage integrator such as AppImageLauncher.

The macOS app requires macOS 14 (Sonoma) or later (the .NET 10 runtime floor). It is signed ad-hoc but not notarized, so Gatekeeper blocks the plain double-click on first launch — right-click the app and choose Open once, or allow it under System Settings → Privacy & Security.

Command-line tool (CLI)

Platform File
Linux x64 aicr-linux-x64
Linux arm64 aicr-linux-arm64
macOS Apple Silicon aicr-osx-arm64
macOS Intel aicr-osx-x64
Windows x64 aicr-win-x64.exe

On Linux and macOS, chmod +x the downloaded binary before running it.

On macOS, a binary downloaded with a browser also carries the quarantine attribute, and Gatekeeper blocks unsigned quarantined binaries even from the terminal. Clear it with:

xattr -d com.apple.quarantine aicr-osx-arm64   # or aicr-osx-x64

Also download example.project.tar.gz from the same release — this is a template project directory you can copy to start a new study.

Install from source

Requires the .NET SDK 10.0 or later. The repo ships per-platform install scripts that build self-contained binaries and install both the CLI and the GUI for the current user (no root/admin needed):

scripts/install-linux.sh        # Linux:   ~/.local + desktop entry and icons
scripts/install-macos.sh        # macOS:   ~/Applications app bundle + CLI
powershell -ExecutionPolicy Bypass -File scripts\install-windows.ps1
# Windows: %LOCALAPPDATA%\Programs\aicr + Start Menu + PATH + Add/Remove Programs

Each script uninstalls with --uninstall (-Uninstall on Windows).

Build manually

dotnet run --project src/cli/ -- run <project-dir>

Or build a self-contained binary:

dotnet publish src/cli/ -c Release -r linux-x64 --self-contained \
  -p:PublishSingleFile=true -p:AssemblyName=aicr -o dist/
./dist/aicr run <project-dir>

Replace linux-x64 with linux-arm64, win-x64, osx-x64, or osx-arm64 for other platforms; use src/gui/ instead of src/cli/ to build the desktop app.


This site uses Just the Docs, a documentation theme for Jekyll.