> ## Documentation Index
> Fetch the complete documentation index at: https://012e27a-docs-2.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://012e27a-docs-2.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://012e27a-docs-2.manicule.dev/api/mcp.
> Every agent surface: https://012e27a-docs-2.manicule.dev/.well-known/llms-manifest.json

# Download & Install Desktop Workspace (/getting-started/installation)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 952 · updated: 2026-11-12 -->
Related: [Import Existing Projects](/getting-started/import-projects.md)

> Install the native BhaiCode AI development workspace on macOS, Windows, or Linux.

The **BhaiCode Desktop App** is a native workspace built with **Tauri 2, Rust, and React 19**.
It uses your operating system's native webview instead of bundling Chromium and Node.js, so
it installs small and starts fast.

<CardGroup cols="3">
<Card title="~7–8 MB" icon="package">Installer size.</Card>

<Card title="~45 MB RAM" icon="memory-stick">Idle memory footprint.</Card>

<Card title="< 350 ms" icon="timer">Cold launch time.</Card>
</CardGroup>

[Download BhaiCode Desktop →](https://bhaico.de/download)

## Supported platforms

| Platform              | Architecture            | Package              | Minimum OS                              |
| --------------------- | ----------------------- | -------------------- | --------------------------------------- |
| macOS (Apple Silicon) | `aarch64` (M1/M2/M3/M4) | `.dmg`               | macOS 12 Monterey+                      |
| macOS (Intel)         | `x86_64`                | `.dmg`               | macOS 12 Monterey+                      |
| Windows               | `x64`                   | `.msi` / `.exe`      | Windows 10 (build 19041+) or Windows 11 |
| Linux                 | `x86_64` & `arm64`      | `.AppImage` / `.deb` | Ubuntu 22.04+, Debian 12+, Fedora 38+   |

## Install

<Tabs>
  <Tab title="macOS">
    <Steps>
<Step title="Download the disk image">Use `BhaiCode-darwin-arm64.dmg` for Apple Silicon or `BhaiCode-darwin-x64.dmg` for
Intel.</Step>

<Step title="Install">Open the `.dmg` and drag **BhaiCode** into **Applications**.</Step>

<Step title="Launch">Open it from Spotlight (`Cmd + Space`, then "BhaiCode") or Launchpad.</Step>
    </Steps>

<Note title="Gatekeeper">macOS may show a security prompt on first launch. Choose **Open** — BhaiCode builds are
signed and notarized with Apple Developer certificates.</Note>
  </Tab>

  <Tab title="Windows">
    <Steps>
<Step title="Download the installer">Use `BhaiCode-Setup-x64.exe` or `BhaiCode-x64.msi`.</Step>

<Step title="Run setup">Double-click the installer and choose an install directory (defaults to
`%LOCALAPPDATA%\Programs\BhaiCode`).</Step>

<Step title="Launch">Open **BhaiCode** from the Start menu or the desktop shortcut.</Step>
    </Steps>

<Tip title="Managed installs">The `.msi` package supports standard Windows deployment and software-distribution
tooling if you roll BhaiCode out across a team.</Tip>
  </Tab>

  <Tab title="Linux">
    BhaiCode ships a standalone **AppImage** and Debian/Ubuntu **`.deb`** packages.

    ```bash title="AppImage (any distro)"
    chmod +x BhaiCode-linux-x64.AppImage
    ./BhaiCode-linux-x64.AppImage
    ```

    ```bash title="Debian / Ubuntu"
    sudo dpkg -i BhaiCode-linux-x64.deb
    sudo apt-get install -f
    ```
  </Tab>
</Tabs>

## First launch

<Steps>
<Step title="Sign in or continue as a guest">Sign in to sync projects across devices, or stay in **local-first / BYOK** mode with no
account.</Step>

<Step title="Configure AI models">Add a key for OpenAI, Anthropic, Google Gemini, or Nous Portal, or connect a local model
through **Ollama** at `http://localhost:11434`. Keys are stored in your OS keychain —
macOS Keychain, Windows Credential Manager, or Linux Secret Service.</Step>

<Step title="Open a project">Click **Open folder** (`Cmd + O` / `Ctrl + O`) and pick any local folder or Git
repository. BhaiCode reads the structure, dependencies, and Git status immediately.</Step>
</Steps>

<CardGroup cols="2">
<Card title="Next: tour the desktop app" icon="monitor" href="/desktop/overview">Architecture, benchmarks, and the two working modes.</Card>

<Card title="Or build in the browser" icon="cloud" href="/getting-started/quickstart">Skip the install and try Cloud Studio first.</Card>
</CardGroup>