Skip to main content

Install and update Kenaz

Download Kenaz from the download page. The Kenaz section there always lists the latest release.

What's published​

PlatformFiles
macOS, Apple Silicon (arm64)kenaz-<version>-darwin-arm64.dmg (installer) and kenaz-<version>-darwin-arm64.zip (the app bundle)
Linux, x86-64 (amd64)kenaz-<version>-linux-amd64.AppImage and kenaz-<version>-linux-amd64.tar.gz
Linux, arm64kenaz-<version>-linux-arm64.tar.gz

There are no Windows or Intel Mac builds. The download page shows SHA-256 checksums for each release.

macOS​

You need macOS 13 (Ventura) or later on Apple Silicon.

  1. Download the .dmg and open it.
  2. Drag the Kenaz app onto the Applications folder shown in the window.
  3. Open Kenaz from Applications.

Release builds are signed with a Developer ID and notarized by Apple, so Gatekeeper opens them without extra steps.

To run workbenches, Kenaz also needs Tart. You don't have to install it first: Kenaz offers to install it the first time you open a workbench. Tart has its own licence; see Tart's licence.

Linux​

Kenaz targets Ubuntu 24.04 or later, on Wayland or X11. It is built against GTK 3 and WebKitGTK 4.1, so your system needs those runtime libraries.

AppImage (amd64):

chmod +x kenaz-*-linux-amd64.AppImage
./kenaz-*-linux-amd64.AppImage

Tarball (amd64 or arm64). The archive has no top-level folder, so extract it into one:

mkdir kenaz && tar -xzf kenaz-*-linux-*.tar.gz -C kenaz
cd kenaz
./kenaz

The tarball also contains kenaz.desktop and kenaz.png if you want a menu entry:

mkdir -p ~/.local/bin ~/.local/share/applications ~/.local/share/icons/hicolor/1024x1024/apps
install -m 0755 kenaz ~/.local/bin/
install -m 0644 kenaz.desktop ~/.local/share/applications/
install -m 0644 kenaz.png ~/.local/share/icons/hicolor/1024x1024/apps/

Keep the kameas-ml folder next to the kenaz program; Kenaz looks for it there.

Workbenches on Linux need code-server installed. See Linux hosts.

Updating​

Kenaz doesn't install updates itself. Releases that include the update check look at the release list on downloads.kameas.ai at most once a day and tell you when a newer version is out (Help → Check for Updates… asks right away; the Check for updates automatically setting turns the daily check off). The check sends no account, device or usage information. Earlier releases don't check at all. To update:

  1. Quit Kenaz.
  2. Download the new release from the download page.
  3. Install it the same way, replacing the old copy.

Your profiles, workbench records and settings live outside the app (mostly under ~/.kenaz), so replacing the app keeps them.

On macOS, quitting Kenaz leaves running workbench VMs running. The next launch picks them up again. Stop your workbenches first if you want a clean start after the update.

Only one copy runs at a time​

If you launch Kenaz while it's already running, the new launch hands over to the running copy and exits. If the previous copy is still quitting, the new one waits up to 10 seconds for it.