Skip to main content

Siya Desktop - Your AI Companion, Always Ready

Experience Siya’s full power through our native macOS application. Built with performance and privacy in mind, the desktop app provides instant access to AI assistance with deep system integration, offline capabilities, and a beautiful native interface.

Download & Installation

Get Started in Minutes

Simple installation process with automatic updates
2

Install Application

  1. Open the downloaded DMG file
  2. Drag Siya to Applications folder
  3. Right-click and select “Open” first time
  4. Grant necessary permissions when prompted

Simple drag-and-drop installation

3

Initial Setup

API Key Configuration

Enter your API keys for cloud models:
  • Anthropic: For Claude models
  • OpenAI: For GPT models
  • Google: For Gemini models
API keys are stored securely in macOS Keychain
Grant these permissions for full functionality:
  • Accessibility: For system automation
  • Files and Folders: For project access
  • Notifications: For alerts and updates

Interface Overview

Beautiful, Native, Powerful

Designed specifically for macOS with attention to every detail
  • Main Window
  • Quick Access
  • Window Modes

Clean, focused interface optimized for productivity

Enhanced Input Area

  • File Attachments: Drag & drop or click to attach
  • MCP Servers: Quick access to connected servers
  • Mode Toggle: Switch between Chat and Task modes
  • Voice Input: Speak your queries naturally
  • Smart Send: Context-aware submission

Top Bar Features

  • Side Menu: Navigation and settings
  • App Insights: Usage stats and performance
  • Workspaces: Project management
  • Folder Access: Browse local files
  • AI Tasks: View and manage automated tasks
  • Casefiles: Access saved contexts

Model Selection

Claude Models

  • Claude Sonnet 4: Fast, efficient responses
  • Claude Opus 4: Advanced reasoning

Other Models

  • Gemini 2.5 Pro: Google’s latest
  • GPT-5: OpenAI’s flagship
  • Local Models: Ollama, LM Studio, etc.

Chat Interface Details

Intelligent Input System

Advanced chat interface with context-aware features
  • Input Area Components
  • Voice & Send Controls
  • Top Bar Navigation

📎 File Attachment

  • Drag & Drop: Drop files directly into chat
  • Multi-file Support: Attach multiple files at once
  • Image Preview: See thumbnails before sending
  • Code Files: Syntax highlighting preview
  • Size Limit: Up to 10MB per file

🔌 MCP Servers

  • Quick Access: Dropdown list of available servers
  • Status Indicators: Green = connected, Gray = disconnected
  • One-click Connect: Enable servers on demand
  • Custom Servers: Add your own MCP integrations
  • Auto-reconnect: Maintains connections

🎯 Mode Selection

  • Chat Mode (Default): Interactive conversation
  • Task Mode: Autonomous task execution
  • Visual Indicator: Clear mode display
  • Keyboard Shortcut: ⌘ + M to toggle
  • Context Preservation: Maintains context on switch

🧠 Model Selector

  • Quick Switch: Dropdown with all models
  • Model Info: Speed/capability indicators
  • Recent Models: Quick access to last used
  • Custom Models: Add local model endpoints
  • Auto-select: Based on task complexity
Pro Tip: Use ⌘ + K to open the command palette for quick access to any feature!

Core Features

Everything You Need, Nothing You Don't

Powerful features designed for developers

Project Management

Intelligent project organization and switching

Auto-Detection

Siya automatically detects:
  • Git repositories
  • Package.json projects
  • Python environments
  • Project configurations
  • Build systems

Project Features

Each project maintains:
  • Separate chat history
  • Custom configurations
  • Isolated memory context
  • Project-specific tools
  • Saved workflows
Use ⌘ + P to quickly switch between projects
  • File System
  • Clipboard
  • Notifications

Deep File System Integration

Native file handling with preview and quick actions
Features:
  • Drag & drop files into chat
  • Quick look preview (Space key)
  • Context menu integration
  • Finder extension
  • Recent files tracking
- Drag files to analyze
- Drop folders to explore
- Paste images directly
- Quick actions menu
- Open in editor

Work Anywhere, Anytime

Full functionality even without internet connection

Local Models

1

Download Models

Download llamafile models for offline use
2

Install Locally

Place in ~/.siya/local-models/
3

Automatic Switching

Siya switches to local models when offline

Available Offline

  • Local file operations
  • Code analysis
  • Git operations
  • Terminal commands
  • Project management
  • Memory persistence

Requires Internet

  • Cloud model access
  • Web search
  • API integrations
  • MCP servers (remote)
  • Package installation
  • Documentation fetch

Advanced Features

Power User Features

Advanced capabilities for maximum productivity
  • Multi-Window
  • Quick Commands
  • Automation

Work on Multiple Projects Simultaneously

Open multiple Siya windows for different contexts

Multi-window workflow management

Use Cases:
  • Frontend + Backend development
  • Documentation + Implementation
  • Multiple client projects
  • Research + Development

Settings & Preferences

Customize Every Aspect

Comprehensive settings for personalizing your experience
  • General
  • Privacy
  • Performance

Appearance

Theme Options

  • Auto: Follow system
  • Light: Always light
  • Dark: Always dark
  • Custom: Create your own

UI Customization

  • Font size: 12-24pt
  • Font family selection
  • Line height adjustment
  • Sidebar width
  • Transparency level
{
  "behavior": {
    "startup": {
      "launchAtLogin": true,
      "showWindow": false,
      "restoreWindows": true
    },
    "window": {
      "alwaysOnTop": false,
      "hideOnDeactivate": false,
      "minimizeToTray": true
    },
    "updates": {
      "autoCheck": true,
      "autoDownload": false,
      "channel": "stable"
    }
  }
}

Keyboard Shortcuts

Master Siya with Keyboard Shortcuts

Complete list of keyboard shortcuts for maximum efficiency
  • Essential
  • Advanced

Troubleshooting

Quick Solutions to Common Issues

Get back to productivity quickly

Installation Issues

1

High Memory Usage

  • Clear memory with ⌘ + K
  • Reduce max context in settings
  • Close unused windows
2

Slow Responses

  • Check internet connection
  • Switch to faster model
  • Disable unnecessary features
3

Crashes

  • Check crash logs in Console
  • Reset settings to default
  • Reinstall if persistent
# Reset all settings
rm -rf ~/.siya/config

# Clear cache
rm -rf ~/.siya/cache

# Full reset (backup first!)
rm -rf ~/.siya

Updates & Roadmap

Always Improving

Regular updates with new features and improvements
  • Update System
  • Coming Soon
1

Automatic Updates

Siya checks for updates daily and notifies you
2

One-Click Install

Updates download and install in the background
3

Release Notes

View detailed changes before updating
You can change update settings in Preferences > General

Summary

Your AI Development Companion

The Siya desktop application brings the full power of AI assistance to your Mac with a native, fast, and privacy-focused experience. With deep system integration, offline capabilities, and a beautiful interface, it’s the perfect companion for modern software development.

Native. Fast. Private. Powerful.