Getting Started

Follow this guide to download, install, configure, and launch Quiper on your Mac.

---

System Requirements

Quiper is compatible with:

• Operating System: macOS 14.6 (Sonoma) or newer.
• Hardware: No special requirements.
• Dependencies: None.

---

Installation

1. Download the Application

• Download the latest pre-compiled disk image (Quiper.dmg) from the Releases page.

2. Copy to Applications

• Double-click the Quiper.dmg file to mount it.
• Drag the Quiper icon into your /Applications directory.

---

Initial Setup & Launching

When you launch Quiper, it will run as a status bar application:

• MenuBar Icon: You will see the Quiper logo in your macOS Menu Bar.
• Default Summon Hotkey: Press ⌥ Space (Option + Space) to summon the floating overlay.
• Hiding: Press ⌥ Space again (or press ⌘ H / ⌘ Q) to dismiss the window.

Notification Permissions

• When Quiper is first opened, macOS will prompt you to allow notifications.
• Crucial: Grant notification access if you plan to use background generation. Quiper’s built-in Web Notification bridge routes web page notifications directly to native macOS user notifications when your chat runs in the background.

Launch at Login

• To ensure Quiper is always active when you reboot your Mac:
  1. Open the Quiper overlay (⌥ Space).
  2. Press ⌘ ⇧ , (Command + Shift + Comma) to open Settings.
  3. Go to the General tab.
  4. Toggle Start at Login to ON. This will write a standard LaunchAgent plist file under ~/Library/LaunchAgents/com.<username>.quiper.plist.

---

Release & Update Channels

You can customize your preferred update channel and manage automated checks or background downloads under the Updates tab. For a detailed reference of updates preferences and channels (Stable, Beta, Nightly), see the Application Settings Guide.

---

Verifying Build Security (Optional)

Since running unsigned apps requires trust, you can verify that the binary you downloaded matches the source code in this repository:

1. Ensure you have the GitHub CLI installed (brew install gh).

2. Open Terminal.

3. Run the cryptographic build provenance verification command:

   gh attestation verify Quiper.dmg --repo sassanh/quiper

4. A successful output guarantees the binary was generated by GitHub Actions directly from the public codebase and has not been altered since compilation.