Installation

Get MyDeskBot Desktop up and running on your computer in minutes.

System Requirements

Supported Platforms

MyDeskBot Desktop is available for:

• macOS 11.0 (Big Sur) or later
• Windows 10 or later (64-bit)
• Linux (Ubuntu 20.04+, Debian 11+, Fedora 34+, Arch Linux)

Hardware Requirements

• CPU: Dual-core processor (Intel Core i5 or equivalent)
• RAM: 4 GB minimum, 8 GB recommended
• Storage: 500 MB free space
• Network: Internet connection for AI features

Installation Methods

macOS

Download and Install

1. Download the latest .dmg file from mydeskbot.dev/download
2. Open the downloaded file
3. Drag MyDeskBot to your Applications folder
4. Open MyDeskBot from Applications

Homebrew Cask (Recommended for Developers)

brew install --cask mydeskbot

Verify Installation

mydeskbot --version

Windows

Download and Install

1. Download the latest .exe installer from mydeskbot.dev/download
2. Run the installer
3. Follow the installation wizard
4. Launch MyDeskBot from the Start Menu or Desktop

Winget (Recommended)

winget install MyDeskBot

Chocolatey

choco install mydeskbot

Linux

Download and Install

1. Download the appropriate package for your distribution:

Ubuntu/Debian (.deb):

sudo dpkg -i mydeskbot_<version>_amd64.deb
sudo apt-get install -f  # Install dependencies

Fedora/RHEL (.rpm):

sudo rpm -i mydeskbot-<version>.x86_64.rpm

Arch Linux:

sudo pacman -U mydeskbot-<version>-x86_64.pkg.tar.zst

AppImage (Universal)

chmod +x MyDeskBot-<version>.AppImage
./MyDeskBot-<version>.AppImage

Flatpak

flatpak install flathub dev.mydeskbot.Desktop

Snap

sudo snap install mydeskbot

First Launch

Initial Setup

When you first launch MyDeskBot, you'll be guided through the setup process:

1. Welcome Screen

   • Click "Get Started" to begin

2. API Key Configuration

   • Choose your AI provider (OpenAI, Anthropic, etc.)
   • Enter your API key
   • Click "Continue"

3. Model Selection

   • Select your preferred AI model
   • Customize model settings (optional)

4. Workspace Setup

   • Choose your default workspace
   • Configure project paths (optional)

5. Complete Setup

   • Click "Finish" to start using MyDeskBot

API Key Setup

You can add multiple API providers:

{
  "providers": {
    "openai": "sk-...",
    "anthropic": "sk-ant-...",
    "gemini": "AIza..."
  }
}

Uninstallation

macOS

brew uninstall --cask mydeskbot

Or manually:

1. Quit MyDeskBot
2. Delete the application from Applications
3. Remove configuration files:

   rm -rf ~/Library/Application\ Support/MyDeskBot
   rm -rf ~/Library/Caches/MyDeskBot

Windows

winget uninstall MyDeskBot

Or use the uninstaller:

1. Open Settings → Apps → Installed Apps
2. Find MyDeskBot
3. Click "Uninstall"

Linux

Ubuntu/Debian:

sudo apt remove mydeskbot

Fedora/RHEL:

sudo dnf remove mydeskbot

Arch Linux:

sudo pacman -R mydeskbot

Updating MyDeskBot

Automatic Updates

MyDeskBot checks for updates automatically and notifies you when a new version is available.

Manual Updates

Check for updates manually:

1. Open MyDeskBot
2. Go to Settings → Updates
3. Click "Check for Updates"

Command Line Update

mydeskbot update

Troubleshooting

Installation Issues

"Cannot verify developer" on macOS:

# Remove quarantine attribute
xattr -cr /Applications/MyDeskBot.app

"Windows Protected your PC" on Windows:

Click "More info" → "Run anyway"

Permission denied on Linux:

# Make the AppImage executable
chmod +x MyDeskBot-<version>.AppImage

First Launch Issues

API Key Not Working:

• Verify the API key is correct
• Check your account has credits
• Ensure the key has necessary permissions

Network Connection Error:

• Check your internet connection
• Verify firewall settings
• Check if the API service is operational

Performance Issues

Application is slow:

• Close unnecessary applications
• Increase allocated memory in Settings
• Check system resources

High CPU Usage:

• Check if background tasks are running
• Disable automatic model preloading
• Update to the latest version

Next Steps

After installation, check out:

• Configuration Guide - Customize MyDeskBot to your needs
• Workflows - Learn common workflows
• Features - Explore MyDeskBot features

Need Help?

• FAQs
• Community Forum
• Support