Skip to content

Installation

openstan is distributed as a self-contained native installer for each supported platform. No Python installation is required — all dependencies are bundled.

Windows

  1. Download the latest openstan-<version>.msi from the GitHub Releases page.
  2. Double-click the .msi file to launch the installer.
  3. Follow the on-screen prompts. openstan is installed per-user by default (no administrator rights needed).
  4. Launch openstan from the Start menu or desktop shortcut.

Windows SmartScreen

On first run, Windows may show a SmartScreen warning because the installer is not yet signed with a paid certificate. Click More info → Run anyway to proceed.

macOS

  1. Download the latest openstan-<version>.dmg from the GitHub Releases page.
  2. Open the .dmg and drag openstan into your Applications folder.
  3. On first launch, right-click the app icon and choose Open, then confirm in the dialog that appears.

Gatekeeper

macOS Gatekeeper will block unsigned apps on first launch. Use right-click → Open rather than double-clicking. This is only required once.

Linux (Debian / Ubuntu)

Download the latest openstan-<version>.deb from the GitHub Releases page and install it:

sudo apt install ./openstan-<version>.deb

After installation, launch openstan from your application menu, or run openstan in a terminal.

Dependencies installed automatically

The .deb package declares the following system dependencies; apt will install them automatically:

  • libegl1
  • libxcb-cursor0
  • libxkbcommon-x11-0

Linux (Fedora / RHEL / CentOS)

Download the latest openstan-<version>.rpm from the GitHub Releases page and install it:

sudo dnf install ./openstan-<version>.rpm

Running from source

If you prefer to run openstan directly from the source code (for development or to use the very latest changes):

Prerequisites

  • Python 3.14 or later
  • uv package manager

Steps

# Clone the repository
git clone https://github.com/boscorat/openstan.git
cd openstan

# Install all dependencies
uv sync

# Run the application
uv run openstan

On Linux you will also need the Qt XCB system libraries:

sudo apt-get install -y \
  libegl1 libgles2 libxcb-cursor0 libxcb-icccm4 libxcb-image0 \
  libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 \
  libxcb-xinerama0 libxcb-xkb1 libxkbcommon-x11-0 \
  libdbus-1-3 libfontconfig1 libfreetype6

Upgrading

To upgrade to a newer version, download the new installer and run it — it will replace the previous installation. Your project data is stored in separate project folders and is not affected by upgrades.

Uninstalling

Go to Settings → Apps → Installed apps, find openstan, and click Uninstall.

Drag the openstan app from Applications to the Trash.

sudo apt remove openstan

sudo dnf remove openstan

Project data

Uninstalling openstan does not delete your project folders or data. These are stored wherever you chose when creating each project.