Skip to content

Installation ​

SlipSurfaceIQ LE runs on Windows and Linux. The easiest way is an installer: it contains Python, Qt and the scientific libraries, so there is nothing else to set up. You can also run the program from source with your own Python.

Installers ​

Version 2026.7.1The packages include Python 3.12, Qt and the scientific libraries; you do not need to install Python or pip.

The installers for this version are not published yet. The release page has its notes; earlier versions are still available to download.

  1. Download the package for your system.
  2. On Windows double-click the MSI. On Linux install it with the command shown, from the folder you downloaded it to; the package manager also installs the Qt desktop libraries it needs.
  3. Start SlipSurfaceIQ LE from the application menu. On Linux the slipsurface command works in a terminal too.

Good to know

  • Windows: the MSI is not signed yet, so Windows SmartScreen may warn before it runs; choose More info → Run anyway. The program is installed under Program Files\SlipSurfaceIQ LE, and a later version replaces it.
  • Linux: the packages need glibc 2.39 or newer and an X11/XWayland desktop. They are tested on Ubuntu 24.04, Fedora 44, openSUSE Leap 16 and current Arch Linux; Tumbleweed uses the openSUSE RPM. openSUSE Leap 15 and SUSE Linux Enterprise 15 are not supported. The RPMs are not signed with a distribution key, so zypper may ask whether to accept them. The program goes to /opt/slipsurface-iq-le.
  • Checksums: compare a download with the SHA256 checksums linked under the table above: sha256sum -c SHA256SUMS --ignore-missing on Linux, Get-FileHash <file> -Algorithm SHA256 in Windows PowerShell.
  • Uninstall through Installed apps on Windows or your package manager on Linux. Your projects and settings are kept.

From source ​

Running from source needs Python 3.10 or newer (3.11 – 3.14 recommended). The required packages are PySide6 (Qt), NumPy, SciPy, Shapely, ReportLab, ezdxf and QtAwesome; the launchers install them for you.

1. Get the program ​

Clone the repository, or download it as a ZIP and unpack it:

bash
git clone https://github.com/hdaltuntas/SlipSurfaceIQ-LE
cd SlipSurfaceIQ-LE

2. Start it ​

SystemCommand
Windowsdouble-click run_windows.bat
Linux./run_linux_mac.sh

macOS has not been tested yet. The program is written to run there too, with the same ./run_linux_mac.sh launcher, but this is not yet confirmed.

On the first run the launcher creates a virtual environment in .venv, installs the requirements and starts the program. It reinstalls them automatically whenever requirements.txt changes.

On Linux the Qt runtime libraries must be present; they normally are on a desktop system. On a minimal installation:

bash
sudo apt install libegl1 libgl1 libxkbcommon0 libfontconfig1 libdbus-1-3          # Debian / Ubuntu
sudo dnf install libglvnd-egl libglvnd-opengl libxkbcommon fontconfig dbus-libs   # Fedora
sudo pacman -S libglvnd libxkbcommon fontconfig dbus                             # Arch Linux
sudo zypper install libglvnd libxkbcommon0 fontconfig libdbus-1-3               # openSUSE

Manual set-up ​

bash
python -m venv .venv
# Windows: .venv\Scripts\activate      Linux: source .venv/bin/activate
pip install -r requirements.txt
python main.py

main.py can also be opened and run from any IDE (VS Code, PyCharm, Spyder). pip install -e . adds the slipsurface command.

Command line ​

bash
python main.py                                    # empty project
python main.py examples/anchored_cut.slp.json     # open a project file
python main.py --example "ACADS EX1(a)"           # open a bundled example
python main.py --list-examples                    # list the bundled examples
python main.py --check                            # check Python and the packages

Next ​

The overview shows a typical workflow; File → Examples opens ready-made models to start from.

SlipSurfaceIQ LE is free and open-source software under the GNU AGPL-3.0.
Source and downloads on GitHub.