Install Desktop
Download Spirit Agent for macOS, Windows, or Linux.
Desktop is the graphical host: chat, workspace files, Git, settings, marketplace, and automations. It shares the local daemon with the CLI.
Download
Use the download page. It picks a build for your OS and architecture from download.spirit.fast.
| Platform | File | Architectures |
|---|---|---|
| macOS | .dmg | x64, arm64 |
| Windows | .exe (NSIS) | x64, arm64, ia32 |
| Linux | .AppImage | x64, arm64 |
You can also take a GitHub Release from latest. Linux releases may include a .deb in addition to the AppImage.
There is no official Homebrew, winget, or apt package for Desktop.
After install
- Open Spirit Agent.
- Open a workspace.
- Connect a provider in Settings → Models. The key goes to the system keyring.
On macOS, if Gatekeeper blocks the first launch, open the app from Finder with Control-click → Open.
On Linux, mark the AppImage executable (chmod +x SpiritAgent-linux-*.AppImage) before running it.
Updates
The download page and CDN latest path always point at the current Desktop build. GitHub Releases keep versioned assets if you need to pin.