Setup
Install CALCIE
macOS alpha
- Download the CALCIE alpha DMG from the release page.
- Drag CALCIE.app into Applications.
- If macOS says CALCIE is damaged, open Terminal and run
xattr -dr com.apple.quarantine /Applications/CALCIE.app. - Open CALCIE from Applications, not from the build folder.
- Grant Microphone, Accessibility, Screen Recording, and Notifications when prompted.
- Use Settings to import ChatGPT memory if you want continuity.
Windows beta
- Download the Windows beta ZIP from the release page.
- Extract the ZIP somewhere outside OneDrive if possible. Example:
C:\CALCIE. - Run
Launch CALCIE.bat. The internal app/runtime folder is bundled for CALCIE itself; testers should not launch files inside it directly. - If SmartScreen warns about the app, choose More info then Run anyway for this alpha tester build.
- If you want full LLM-backed answers, copy the top-level
.env.examplenext toLaunch CALCIE.batto.envand 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.
- On Windows, copy the top-level
.env.examplenext toLaunch CALCIE.batto.env. On macOS alpha, use the same file in your CALCIE runtime/project root. - Open Google AI Studio.
- Sign in with your Google account.
- Create a free Gemini API key.
- Open the new
.envfile in a text editor. - Paste your key like this:
GEMINI_API_KEY=your_key_here. - Save the file.
- 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
- Microphone: push-to-talk voice capture.
- Accessibility: controlled keyboard/mouse actions you request.
- Screen Recording: screen vision and screen memory.
- Notifications: alerts and update messages.