Installation
Choose the artifact for your platform:
| Platform | File | Notes |
|---|---|---|
| Windows | OpenCluely-Setup-*.exe |
NSIS installer — installs app + adds to Start Menu |
| Linux | *.deb |
Debian/Ubuntu — auto-pulls system deps (Python, ffmpeg, GTK) |
| Linux | *.AppImage |
Universal — no install, just chmod +x and run |
macOS: no pre-built build is shipped. The app is unsigned/un-notarized, so macOS Gatekeeper blocks it as "damaged". Run OpenCluely from source instead:
git clone https://github.com/TechyCSR/OpenCluely && cd OpenCluely && ./setup.shRequires Node.js 18+. See the README for details.
First Run
On first launch, OpenCluely opens the Settings window automatically for your Google Gemini API key.
Get a free key from Google AI Studio. You can also edit .env directly.
Optional: Local Whisper (offline speech)
Install Python 3.10+ and ffmpeg, then run:
./setup.sh --skip-install-system-depsChecksums
See SHA256SUMS.txt attached to this release.
What's Changed
Summary
This release includes 2 commits since v1.8.6.
Features
Improvements
- Refactor macOS environment path resolution, update User-Agent handling, and simplify window creation options (
bc6dae5)
Full Changelog: v1.8.6...v1.8.7