Skip to content

install.md

Latest commit

 

History

History
77 lines (50 loc) · 3.3 KB

install.md

File metadata and controls

77 lines (50 loc) · 3.3 KB
Raw

Installing Thuki

Requirements: macOS 13.4 (Ventura) or later, Apple Silicon (M1-M5).

Recommended: one-line install

curl -fsSL https://thuki.app/install.sh | sh

This downloads the latest Thuki.dmg over HTTPS, verifies its RSA-4096 signature with the openssl already on your Mac, and installs it to /Applications. Because the download arrives without a quarantine flag, Thuki opens cleanly with no Gatekeeper prompt and no manual xattr step.

On first launch macOS asks for two permissions: Accessibility (the global hotkey that summons Thuki from any app) and Screen Recording (the /screen command). Grant both once; they persist across restarts. Onboarding then downloads a starter model right inside the app.

The sections below cover the alternative paths.

Inspect the install script

Read it in the terminal without saving anything:

curl -fsSL https://thuki.app/install.sh | less

Or visit thuki.app/install.sh to download it and open the saved file in an editor first.

Nightly (side by side with stable)

curl -fsSL https://thuki.app/install.sh | THUKI_CHANNEL=nightly sh

Same script URL; the THUKI_CHANNEL=nightly env (or sh -s -- --nightly) installs Thuki Nightly.app beside stable Thuki.app. Nightly uses a different bundle id (com.quietnode.thuki.nightly), so data, Keychain secrets, and TCC grants stay separate. Not for production. Do not run both at once: they both claim double-tap Control and will fight over the hotkey.

Manual install (download the DMG)

Prefer to download by hand? Grab the DMG and clear the quarantine flag yourself.

  1. Download Thuki.dmg from the latest stable release, or grab the bleeding-edge build from the nightly channel, rebuilt automatically from main.

  2. Double-click Thuki.dmg to open it, then drag the app onto the Applications folder shortcut. Stable ships as Thuki.app; nightly as Thuki Nightly.app.

  3. Eject the disk image (drag it to Trash in the Finder sidebar, or right-click and choose Eject).

  4. Before opening for the first time, run this command in Terminal (use the path that matches the channel you installed):

    # stable
xattr -rd com.apple.quarantine /Applications/Thuki.app

# nightly
xattr -rd com.apple.quarantine "/Applications/Thuki Nightly.app"

    Why is this needed? Thuki ships outside the Mac App Store, so Gatekeeper blocks it until this one-time command clears the quarantine flag. It is safe and documented by Apple. The one-line installer does this for you.

  5. Open the app. It will appear in your menu bar.

Build from source

Prerequisites: Bun and Rust

# Clone and install dependencies
git clone https://github.com/quiet-node/thuki.git
cd thuki
bun install

# Launch in development mode (hot-reload frontend)
bun run dev

See CONTRIBUTING.md for the full development setup guide.

To produce a standalone app instead of running the dev server, build it and open the bundle directly:

bun run build:all
open src-tauri/target/release/bundle/macos/Thuki.app