> ## Documentation Index
> Fetch the complete documentation index at: https://bollyai.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Desktop App

> Download the Bolly desktop app for macOS, Windows, or Linux with full computer use support

The desktop app is the full Bolly experience — it includes everything in the web version plus **computer use** capabilities: screenshots, keyboard control, mouse control, bash commands, and file management across your machine.

<Info>The desktop app is built with [Tauri 2](https://tauri.app) and runs a native Rust backend with a SvelteKit frontend.</Info>

## Download

Download the latest version for your platform from GitHub Releases:

<Card title="Download Bolly Desktop" icon="download" href="https://github.com/triangle-int/bolly/releases">
  Choose your platform: macOS, Windows, or Linux.
</Card>

### Available builds

| Platform | Architecture            | File                         |
| -------- | ----------------------- | ---------------------------- |
| macOS    | Apple Silicon (M1+)     | `bolly_x.x.x_aarch64.dmg`    |
| Windows  | x86\_64                 | `bolly_x.x.x_x64-setup.exe`  |
| Linux    | x86\_64                 | `bolly_x.x.x_amd64.AppImage` |
| Linux    | x86\_64 (Debian/Ubuntu) | `bolly_x.x.x_amd64.deb`      |

## Installation by platform

### macOS

<Steps>
  <Step title="Download the DMG">
    Download the `.dmg` file from the [releases page](https://github.com/triangle-int/bolly/releases).
  </Step>

  <Step title="Install">
    Open the DMG and drag Bolly to your Applications folder.
  </Step>

  <Step title="First launch">
    Open Bolly from Applications. macOS may warn about an unverified developer — go to **System Settings > Privacy & Security** and click **Open Anyway**.
  </Step>

  <Step title="Set up in the app">
    On first launch, Bolly will guide you through setup — including entering your Anthropic API key — right in the app.
  </Step>
</Steps>

### Windows

<Steps>
  <Step title="Download the installer">
    Download the `.exe` installer from the [releases page](https://github.com/triangle-int/bolly/releases).
  </Step>

  <Step title="Run the installer">
    Double-click the installer and follow the prompts. Windows SmartScreen may show a warning — click **More info > Run anyway**.
  </Step>

  <Step title="Launch and set up">
    Open Bolly from the Start Menu or desktop shortcut. The app will walk you through the initial setup including your API key.
  </Step>
</Steps>

### Linux

<Steps>
  <Step title="Download">
    Choose the `.AppImage` (universal) or `.deb` (Debian/Ubuntu) from the [releases page](https://github.com/triangle-int/bolly/releases).
  </Step>

  <Step title="Install">
    <CodeGroup>
      ```bash AppImage theme={null}
      chmod +x bolly_*.AppImage
      ./bolly_*.AppImage
      ```

      ```bash Debian/Ubuntu theme={null}
      sudo dpkg -i bolly_*.deb
      ```
    </CodeGroup>
  </Step>

  <Step title="Set up in the app">
    On first launch, Bolly will guide you through the setup process.
  </Step>
</Steps>

## Computer use capabilities

The desktop app enables Bolly to interact with your computer directly. These capabilities are **opt-in** and require your confirmation:

| Capability          | Description                                         |
| ------------------- | --------------------------------------------------- |
| **Screenshots**     | Capture screen content to understand visual context |
| **Keyboard**        | Type text and use keyboard shortcuts                |
| **Mouse**           | Click, scroll, and drag across your screen          |
| **Bash/Terminal**   | Execute shell commands                              |
| **File Management** | Read, write, and organize files on your system      |

<Warning>Computer use gives Bolly direct access to your desktop. Always review what Bolly is doing, especially with shell commands and file operations. Actions require your confirmation in the UI.</Warning>

## Multi-machine support

Bolly's computer use works across multiple machines. If you have multiple Bolly desktop instances running on different computers, they can coordinate tasks across machines.

## Data location

The desktop app stores data in the same `~/.bolly/` directory as other installation methods:

| Platform | Default path            |
| -------- | ----------------------- |
| macOS    | `~/.bolly/`             |
| Windows  | `%USERPROFILE%\.bolly\` |
| Linux    | `~/.bolly/`             |

## Updating

The desktop app checks for updates automatically. When a new version is available, you'll see a notification in the app. You can also manually download the latest version from the [releases page](https://github.com/triangle-int/bolly/releases). See the [full updating guide](/docs/installation/updating) for more details.

## Next steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/docs/installation/configuration">
    Customize Bolly's personality, heartbeat, and memory behavior.
  </Card>

  <Card title="API Keys" icon="key" href="/docs/installation/api-keys">
    Learn about optional keys for Google AI and ElevenLabs.
  </Card>
</CardGroup>