Downloads
Download PeerAI Studio for your platform, or install via Homebrew.
Install via Homebrew
RecommendedTap the PeerAI repository
$ brew tap PeerIslands-PeerAI/tapInstall stable or alpha release
$ brew install --cask peerai-studioOr alpha: brew install --cask peerai-studio-alpha
Launch from Applications or Spotlight
Update: brew upgrade --cask peerai-studio
Uninstall: brew uninstall --cask peerai-studio
Direct Download (.dmg)
Download the .dmg for your architecture ( aarch64 for Apple Silicon, x64 for Intel)
Open the DMG and drag PeerAI Studio into Applications
If blocked by Gatekeeper, clear quarantine:
$ xattr -d com.apple.quarantine /Applications/PeerAI\ Studio.appLaunch from Applications or Spotlight
To update: download the latest DMG and replace the app in /Applications
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| macOS | 10.15 (Catalina) | 13.0+ (Ventura) |
| Architecture | Apple Silicon / Intel | Apple Silicon |
| RAM | 4 GB | 8 GB |
| Disk Space | 500 MB | 1 GB |
| MongoDB | Optional | MongoDB 7.0+ |
First Launch
Click "Open" when your OS asks to confirm the app from an identified developer.
Enter your license key. Contact your admin or visit the licensing dashboard.
The app creates ~/.peerai/ for config, credentials, and logs.
The Python sidecar starts on port 8765. A splash screen shows 14-step startup progress.
Post-Install Configuration
MongoDB (Optional)
PeerAI Studio works without MongoDB using local JSON files. For full functionality (Ask PeerAI, analytics), set up MongoDB:
$ brew tap mongodb/brew$ brew install mongodb-community$ brew services start mongodb-communityThen go to Settings > General and set the MongoDB URL (default: mongodb://localhost:27017)
API Keys
Configure LLM providers in Settings > LLM Providers:
- OpenAI, Anthropic, Google AI, or OpenRouter API key
- (Optional) Exa search key for Ask PeerAI web search
- (Optional) LlamaCloud key for enhanced document parsing
Credential Storage
By default, secrets are stored in ~/.peerai/credentials.json with restricted permissions (0600).
You can switch to macOS Keychain in Settings > General > Credential Backend.
Troubleshooting
Backend won't start
$ lsof -i :8765$ pkill -f python-backend$ curl http://localhost:8765/healthPress Cmd+D / Ctrl+D in the app to open the startup debug panel.
Reset configuration
$ mv ~/.peerai ~/.peerai.bakRelaunch the app — a fresh ~/.peerai/ directory will be created automatically.
View logs
$ tail -f ~/.peerai/logs/studio.logbrew uninstall --cask peerai-studioManual: drag app to Trash, then rm -rf ~/.peerai/