Overview

Zeus Desktop is a native desktop application that provides a smoother AI interaction experience with local feature integration.

​

Overview

The Desktop application is built on Electron and supports macOS, Windows, and Linux platforms.

​

Advantages

​

System Requirements

​

Installation

​

macOS

1. Download the .dmg installer
2. Open the DMG file
3. Drag Zeus into the Applications folder
4. On first launch, right-click and select “Open” to bypass Gatekeeper

​

Windows

1. Download the .exe installer
2. Run the installer
3. Follow the wizard to complete installation
4. Launch Zeus from the Start menu

​

Linux

• Debian/Ubuntu: Install with sudo dpkg -i zeus_x.x.x_amd64.deb
• Generic: Download the AppImage, add execute permissions, and run directly

​

Architecture

​

Connection Configuration

The Desktop application needs to connect to a Zeus backend service.

​

Cloud Mode

Connect to a hosted Zeus service:

1. Open Settings
2. Enter the server URL (e.g., https://zeus.your-domain.com)
3. Log in with your account
4. Start using

​

Local Mode

Connect to a locally running Zeus service:

1. Ensure the local backend is running
2. Set the server URL to http://localhost:3000
3. Log in or use a local account

​

Features

​

Local File Access

The Desktop application can directly access the local file system, including reading files, writing files, and listing directory contents.

​

System Integration

• Clipboard - Read and write the system clipboard
• Notifications - Native system notifications
• Tray Icon - Quick access from the system tray
• File Association - File type association support

​

Keyboard Shortcuts

​

Offline Features

Some features remain available without a network connection:

• View conversation history (local cache)
• File preview
• Settings modification

​

Device Authentication

The Desktop application uses a device authentication mechanism:

​

Device Management

You can manage authorized devices from the Web platform:

1. Go to Settings → Device Management
2. View all connected devices
3. Revoke authorization for unwanted devices

​

Differences from Web

​

Troubleshooting

​

Application Won’t Start

1. Check system requirements
2. Delete the configuration directory and retry (macOS: ~/Library/Application Support/Zeus, Windows: %APPDATA%\Zeus)

​

Cannot Connect to Backend

1. Check network connectivity
2. Verify the server URL is correct
3. Check firewall settings
4. Try logging in again

​

File Access Permissions

macOS users may need to grant file access permissions:

1. Open System Preferences → Security & Privacy → Privacy
2. Allow Zeus access under “Files and Folders”