Installing the Software
=======================

SpyDE ships as a self-contained desktop installer for Windows, macOS, and Linux.
The installer is small; on **first launch** it sets up the Python analysis
environment (including the GPU-correct PyTorch wheel) with `uv <https://docs.astral.sh/uv/>`__.
That first run needs a network connection and may take a few minutes — progress
shows in the app's log panel. Later launches are instant.

Download
--------

.. The table below is regenerated by the Prepare Release workflow
   (scripts/update-download-links.mjs) — edit the markers, not the table.

.. spyde:download-table:start

**Download SpyDE v0.3.0:** `all releases <https://github.com/CSSFrancis/spyde/releases>`__

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Platform
     - Download
   * - **Windows**
     - `SpyDE-Setup-0.3.0.exe <https://github.com/CSSFrancis/spyde/releases/download/v0.3.0/SpyDE-Setup-0.3.0.exe>`__
   * - **macOS** (Apple Silicon)
     - `SpyDE-0.3.0-arm64-mac.zip <https://github.com/CSSFrancis/spyde/releases/download/v0.3.0/SpyDE-0.3.0-arm64-mac.zip>`__
   * - **Linux**
     - `SpyDE-0.3.0.AppImage <https://github.com/CSSFrancis/spyde/releases/download/v0.3.0/SpyDE-0.3.0.AppImage>`__

.. spyde:download-table:end

Notes
-----

- **macOS** builds are signed + notarized, so they open without a Gatekeeper
  prompt. Unzip the download and drag **SpyDE.app** to *Applications*. (A ``.dmg``
  is also attached to each release if you prefer that; the ``.zip`` is the simplest
  download and is the same signed app the auto-updater installs.)
- **Windows** installers are currently unsigned — SmartScreen may warn on first
  run; choose *More info → Run anyway*. The NSIS installer is per-user (no admin).
- **Linux**: ``chmod +x SpyDE-*.AppImage && ./SpyDE-*.AppImage``.
- The app **auto-updates** on its channel (release-candidate builds follow the
  beta channel; stable builds follow stable). Check via *Help → Check for
  Updates…*.