Download & Install
Go to the download page
Download the macOS / Windows installer
- macOS
- Windows
- Open the download page and pick the build for your chip:
- Apple Silicon (M1/M2/M3/M4): download the
arm64build - Intel: download the
x64build
- Apple Silicon (M1/M2/M3/M4): download the
- Open the downloaded
.dmgand drag CowAgent into your Applications folder. - Launch CowAgent from Launchpad or Applications.
Auto Update
The desktop client has built-in auto-update. When a new version is available it is detected automatically; you can also manually “Check for updates” from the menu in the bottom-left corner and upgrade with one click.Desktop vs. Command-line Deployment
- Desktop client: best for personal use on your own computer — works out of the box, GUI-based, auto-updating.
- Command-line deployment: best for developers or long-running servers with more customization. See Quick Start.
Access from a Browser
Once the desktop client is running, it listens on port9876 locally, and its backend is exactly the same Web console. So while the app is open you can also just point your browser at http://localhost:9876 for the same full experience as the client UI.
Local Data Storage
All data of the desktop client is stored on your machine:- Config directory:
~/.cowin your home folder, holdingconfig.json(model keys, channels, etc.) along with logs, cache and other runtime data. - Workspace:
~/cowby default, holding chat history, knowledge base, memory, skills, scheduled tasks and other files produced by the Agent.
