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

# Desktop app

> Run Prisme.ai in a native macOS and Windows app: native sign-in (SSO + MFA), downloads, session reuse, and automatic updates.

<Warning>
  **Preview.** The desktop app is an early preview. Expect rough edges. Please
  report anything odd on [GitHub](https://github.com/prismeai/desktop/issues).
</Warning>

The Prisme.ai desktop app runs the platform in a dedicated native window on
**macOS and Windows**. It connects to your own Prisme.ai server, so the
interface always matches your server's version, with native sign-in and
automatic updates.

## Download

<CardGroup cols={2}>
  <Card title="Download for macOS" icon="apple" href="https://github.com/prismeai/desktop/releases/latest/download/Prisme.ai-macOS.dmg">
    Apple silicon + Intel (`.dmg`). Requires macOS 10.15 or later.
  </Card>

  <Card title="Download for Windows" icon="windows" href="https://github.com/prismeai/desktop/releases/latest/download/Prisme.ai-Windows-setup.exe">
    64-bit (`.exe`). Requires Windows 10 or later.
  </Card>
</CardGroup>

Each button downloads the latest version directly. Older builds and the `.msi`
installer are on the [Releases page](https://github.com/prismeai/desktop/releases/latest).

## Install

<Tabs>
  <Tab title="macOS">
    1. Open the downloaded `.dmg`.
    2. Drag **Prisme.ai** into **Applications**.
    3. Launch it. The app is signed and notarized by Apple, so it opens directly.
  </Tab>

  <Tab title="Windows">
    1. Run the downloaded installer.
    2. During the preview the installer is not yet code-signed, so Windows
       SmartScreen may show an "unknown publisher" notice: click
       **More info → Run anyway**.
  </Tab>
</Tabs>

## First launch

<Steps>
  <Step title="Enter your server">
    Type your Prisme.ai **API URL** (for example `https://api.your-company.com`).
    It's remembered for next time.

    You'll find it in the platform under **Settings → Connections**, in the
    **Connection endpoints** box — copy the **API URL** (the one ending in
    `/v2`).

    <Frame caption="Settings → Connections → Connection endpoints">
      <img src="https://mintcdn.com/prismeai/fTJIblr5C_-1SQ9Q/images/desktop-app-connection-endpoints.png?fit=max&auto=format&n=fTJIblr5C_-1SQ9Q&q=85&s=d585782fe6696719f8e526f057488185" alt="The Connection endpoints box in Settings, showing the Platform URL and API URL to use in the desktop app" width="2982" height="1412" data-path="images/desktop-app-connection-endpoints.png" />
    </Frame>
  </Step>

  <Step title="Sign in">
    Sign in with your usual method (SSO, MFA) in the native sign-in window. No
    password or token is stored by the app.
  </Step>

  <Step title="You're in">
    The app reuses your session across launches and updates itself automatically
    when a new version ships.
  </Step>
</Steps>