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

Windows installers are code-signed via SignPath Foundation (approval pending). Until signing is active, Windows may show a SmartScreen warning on first run. Click More info → Run anyway to proceed. See the Code signing policy for details.

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.

Code signing

Windows installers for openstan are code-signed through the SignPath Foundation, which provides free code signing for open-source projects. SignPath Foundation is a non-profit organisation that issues certificates on behalf of open-source maintainers to help users verify the authenticity and integrity of downloaded software.