Quick Start Guide

Get up and running with Siya in minutes - installation, setup, and first tasks

Welcome to Siya!

This guide will help you get started with Siya in just a few minutes. Let’s begin your journey with the most advanced AI assistant available today.

System Requirements

macOS Requirements

macOS Desktop App

Currently available for macOS with Windows and Linux coming soon

1. Operating System

   macOS 11.0 (Big Sur) or later

2. Memory

   8GB RAM minimum (16GB recommended for best performance)

3. Storage

   2GB available disk space

4. Internet

   Required for AI features (optional for local models)

5. Processor

   Apple Silicon (M1/M2/M3) or Intel processor

Coming Soon

Windows

Native Windows application in development

Linux

Support for major Linux distributions

Mobile

iOS and Android apps planned

Installation

1. Download Siya

   Download for macOS

   Apple Silicon (M1/M2/M3) - Recommended for best performance

   Intel version coming soon. The download will start immediately when you click the link.

2. Install the Application

   1. Open the downloaded Siya.dmg file
   2. Drag the Siya icon to your Applications folder
   3. Eject the disk image

   
3. First Launch

   On first launch, macOS may show a security warning. Click “Open” to confirm you want to run the app.

   1. Open Siya from your Applications folder
   2. If prompted, click “Open” to confirm
   3. Grant necessary permissions when requested

Initial Setup

Account Setup

1. Create Account

   Create your Siya account or sign in with existing credentials

2. Choose Plan

   Select your subscription plan based on your needs

3. Complete Onboarding

   Follow the guided setup to configure your preferences

Preferences

Navigate to Siya → Preferences to customize:

Theme

Choose between light and dark mode

Shortcuts

Set up keyboard shortcuts

Notifications

Configure alert preferences

Models

Select your preferred AI model

Your First Tasks

Simple Examples

Example 1: Simple Question

What's the weather like in San Francisco?

Example 2: Code Generation

Create a Python function that calculates the fibonacci sequence

Example 3: Data Analysis

Analyze this CSV file and create a summary with key statistics

Advanced Examples

Example 4: Web Research

Research the top 5 JavaScript frameworks in 2024 and compare their features

Example 5: Add Integrations

Configure the GitHub MCP server for me
Add the stock market MCP server
Set up PostgreSQL database connection

Example 6: Create Automations

Create a hook to notify me when tasks complete
Set up automatic git commits after file edits
Make a hook that logs all my file operations

Understanding the Interface

Main Components

Input Area

Where you type or paste your requests. Supports multi-line input and file uploads.

Conversation View

Shows the ongoing dialogue with Siya with syntax highlighting and rich formatting.

Status Bar

Displays current activity, agent status, and progress indicators.

Toolbar

Quick access to new chat, history, settings, and help.

Execution Modes

Choose Your Working Style

Siya adapts to how you prefer to work with two distinct modes

Chat Mode (Interactive)

Perfect for:

• Exploratory questions
• Step-by-step guidance
• Iterative refinement
• Learning new concepts
• Direct tool usage

Simply start typing your question or request to use Chat Mode

Task Mode (Autonomous)

Perfect for:

• Complex projects
• Multi-step operations
• Batch processing
• Automated workflows
• Production tasks

Start with action words like “Create”, “Build”, “Analyze”

Working with Files

1. Uploading Files

   • Drag and drop files into the chat window
   • Or click the attachment button
   • Multiple files supported

   Supported Formats

   • Text files (.txt, .md, .json)
   • Code files (.py, .js, .java, etc.)
   • Data files (.csv, .xlsx)
   • Documents (.pdf, .docx)
2. Saving Results

   • Click the save button on any response
   • Use keyboard shortcut ⌘+S
   • Results are saved to your designated folder

Extending Siya

MCP Integration (Easy Setup)

Automatic Configuration

Siya can automatically configure integrations for you! Just ask:

GitHub

"Add the GitHub MCP server"

Siya will find the right MCP server, guide you through configuration, set up authentication if needed, and verify everything works.

Hooks for Automation

Create Custom Automations

Simply describe what you want and Siya will create the appropriate hook:

Notifications

"Notify me when any task completes"

Best Practices

Writing Effective Prompts

Be Specific

✅ “Create a Python script that reads a CSV file and generates a bar chart”

Avoid Vague

❌ “Help with Python”

Provide Context

✅ “I’m getting a TypeError in my React component when trying to map over an array”

Avoid Unclear

❌ “Fix this error”

Getting Better Results

• Break Down Complex Tasks: Let Siya create a plan first
• Use Follow-up Questions: Refine results through conversation
• Provide Sample Data: Include examples of input/output
• Specify Constraints: Mention any limitations or requirements

Common Tasks

Development

Create a REST API with Express.js that handles user authentication

Data Processing

Clean this dataset by removing duplicates and filling missing values

Content Creation

Write a professional email declining a meeting invitation

Research

Compare AWS, Google Cloud, and Azure for hosting a web application

Keyboard Shortcuts

Tips for Success

1. Start Simple

   Begin with straightforward tasks to understand Siya’s capabilities

2. Be Patient

   Complex tasks may take a moment to process

3. Save Important Work

   Keep copies of valuable outputs

4. Explore Features

   Try different types of tasks to discover Siya’s full potential

5. Use History

   Learn from previous successful interactions

6. Add Integrations

   Extend capabilities with MCP servers

7. Automate Workflows

   Create hooks for repetitive tasks

Getting Help

In-App Help

• Click the Help menu
• Use the ? button in toolbar
• Type “help” in chat

Documentation

Access through Help menu or visit our docs site

Support

• Email: [e-mail]
• Response within 24 hours

What’s Next?

Continue Your Journey

Now that you’re set up, explore these resources to master Siya:

Desktop Application

Master the macOS app features

Model Selection

Choose your AI model

Execution Modes

Master chat and task modes

Agent Capabilities

Learn what each agent can do

MCP Integration

Extend Siya’s capabilities

Hooks Automation

Automate your workflows

Congratulations! You’re ready to start using Siya. Welcome to a new era of AI assistance!

---

Welcome to Siya - Your AI team is ready to assist!