Setup

Install CALCIE

macOS alpha

  1. Download the CALCIE alpha DMG from the release page.
  2. Drag CALCIE.app into Applications.
  3. If macOS says CALCIE is damaged, open Terminal and run xattr -dr com.apple.quarantine /Applications/CALCIE.app.
  4. Open CALCIE from Applications, not from the build folder.
  5. Grant Microphone, Accessibility, Screen Recording, and Notifications when prompted.
  6. Use Settings to import ChatGPT memory if you want continuity.

Windows beta

  1. Download the Windows beta ZIP from the release page.
  2. Extract the ZIP somewhere outside OneDrive if possible. Example: C:\CALCIE.
  3. Run Launch CALCIE.bat. The internal app/runtime folder is bundled for CALCIE itself; testers should not launch files inside it directly.
  4. If SmartScreen warns about the app, choose More info then Run anyway for this alpha tester build.
  5. If you want full LLM-backed answers, copy the top-level .env.example next to Launch CALCIE.bat to .env and add your API keys.

The Windows beta ZIP includes the tray app and bundled local runtime together. Your testers should not need to clone the repo or open a Terminal first.

Important alpha note

CALCIE 0.1.0 is an unsigned / not-yet-notarized macOS alpha. Some Macs will block the first launch after download. If that happens, copy CALCIE into Applications first, then run the command below once:

xattr -dr com.apple.quarantine /Applications/CALCIE.app

After that, open CALCIE from Applications.

First-run memory import

CALCIE can start empty. If you want it to remember context from ChatGPT, copy the prompt inside Advanced Options, paste it into ChatGPT, then paste the fenced response back into CALCIE.

The import stays local by default in calcie_profile.local.json and .calcie/profile_imports/.

API keys

You can still test some deterministic/local features without your own provider key, but richer chat, search, and reasoning flows work much better with a Gemini key.

  1. On Windows, copy the top-level .env.example next to Launch CALCIE.bat to .env. On macOS alpha, use the same file in your CALCIE runtime/project root.
  2. Open Google AI Studio.
  3. Sign in with your Google account.
  4. Create a free Gemini API key.
  5. Open the new .env file in a text editor.
  6. Paste your key like this: GEMINI_API_KEY=your_key_here.
  7. Save the file.
  8. Restart CALCIE after editing the file.

Good default for testers: add only GEMINI_API_KEY first. You can ignore the other optional keys unless you specifically want those providers.

Current architecture note: both the macOS alpha and Windows beta still run a local CALCIE runtime on your machine for app control, player control, hotkeys, voice, and screen features. Render is currently used for cloud-side services like updates, not as a replacement for that local runtime.

Permissions