Installation

Get Canoryn running on your Mac in under 5 minutes.

System Requirements

Requirement	Minimum	Recommended
macOS	13.0 (Ventura)	14.0+ (Sonoma)
RAM	8GB	16GB+
Storage	2GB	10GB (for local AI models)
Processor	Apple Silicon or Intel	Apple Silicon

Download

Get the latest version of Canoryn for macOS:

Download Canoryn for macOS (Universal DMG)

Requirements: macOS 15.0+ (Sequoia) with Apple Silicon (M1/M2/M3) recommended.

Setup

1. Open Canoryn.dmg and drag the app to Applications.
2. Open the App (macOS Gatekeeper Warning): Because Canoryn is distributed directly and not signed with a paid Apple Developer certificate, macOS Gatekeeper may show a warning when you first launch it.
   • To open: Right-click (or Control-click) Canoryn.app in your Applications folder and select Open. In the confirmation dialog that appears, click Open.
   • Via Terminal: Alternatively, you can clear the quarantine flag by running this command in Terminal:

     xattr -cr /Applications/Canoryn.app

3. Launch Canoryn and grant the required system permissions:
   • Accessibility: To control windows and type text.
   • Screen Recording: To see the screen (processed locally).
   • Full Disk Access: To manage files.

Deep Links

Canoryn supports deep linking for quick installs of agents:

canoryn://install?id=...

When you first launch Canoryn, you'll be prompted to:

1. Grant Permissions

Canoryn needs certain permissions to work its magic:

Permission	Why We Need It	What We Don't Do
Accessibility	Control apps, automate UI	Never read passwords or keystrokes
Screen Recording	Let AI "see" context	Never record or transmit
Microphone	Voice commands	Never sent to servers

Important

All permissions are used locally. No data leaves your Mac.

2. Set Up AI Provider

Choose your AI backend:

Local (Recommended for Privacy)

# Install Ollama
brew install ollama

# Pull a model
ollama pull llama3.2

Cloud Providers (Optional)

• OpenAI - Requires API key
• Anthropic Claude - Requires API key
• Groq - Free tier available

3. Connect Services (Optional)

Enhance Canoryn with integrations:

• Spotify - Music control and mood-based playlists
• Apple Shortcuts - Trigger existing shortcuts
• Calendar - Context-aware scheduling

Verify Installation

Open Canoryn and try:

1. Click the microphone button
2. Say: "What can you do?"
3. Canoryn should respond with its capabilities

Troubleshooting

If voice commands don't work, check System Settings → Privacy & Security → Microphone.

Next Steps

• Quick Start - Build your first agent
• How It Works - Understand the architecture