Kuzy on Mac.
The desktop app is an Electron shell over the same Python agent the CLI runs. Build from source today; a signed and notarized binary follows once the Apple Developer cert is in place.
◆ no signed binary published yet
We don't have an Apple Developer cert configured yet, so there's no signed .dmg on the GitHub release. The build pipeline lives in .github/workflows/release.yml and turns on automatically once the secrets ship.
In the meantime, build it locally:
◆ build from source
bash
git clone https://github.com/bulbulogludemir/kuzy.git
cd kuzy
# Python agent (CLI + Ink TUI core)
python3 -m pip install --user -e .
# Mac desktop app (Electron + React + Tailwind v4)
cd desktop
npm install
npm run devSee desktop/README for the build flags, packaging steps, and keyboard shortcuts.
◆ requirements
macOS
13 Ventura or later
Architecture
Apple Silicon · Intel
Tooling
git · python3.11+ · node 20+
Disk
~600 MB (sources + node_modules)
Why no .dmg yet?
Shipping a download that triggers a Gatekeeper warning would be worse than not shipping one. The desktop app builds and runs fine locally; we'll publish the signed/notarized .dmg as soon as the cert is configured.