1. Clone the github repository

This document describes how to install Sculptor and its dependencies. For now the project has not been published on PyPi, yet. Therefore, the first step is to clone the Sculptor repository from github.

To do this simply clone the repository to your folder of choice.

git clone

The current version of Sculptor is designed to work with python >= 3.9.

2. Installing Sculptor and its requirements

Navigate to the main folder of sculptor. It should contain the file as well as requirements.txt, conda_requirements.yml, and environment.yml.

2.2 Installing Sculptor (using via pip)

One can attempt a pure pip installation. Due to issues with pytables and PyQt5 installations via pip on Mac OSX M1/M2 machines, one needs to first install these packages independently:

pip install PyQt5
pip install tables

Then you need to navigate into the main package folder with the file and execute:

pip install -e .

This will install all of the remaining dependencies and the Sculptor package itself.

2.3 Installing Sculptor (using requirements.txt via pip)

In the sculptor github repository you will find a ‘requirements.txt’, which allows you to install the necessary requirements using pip from the main sculptor directory:

pip install -r requirements.txt

If you are managing your python installation with Anaconda, this can work as well as long as you have pip installed in your Anaconda working environment. However, it may lead to issues if a pip version and an anaconda version of the same package (e.g., astropy) is installed.

In the same folder you then execute:

pip install -e .

This will install the Sculptor package.

3. Open up the sculptor GUI

To test whether the installation was successful, open your terminal and simply type


If this opens up the Sculptor GUI, the installation was a success!

To test Sculptor further one can also load the example spectrum via

run_sculptor --ex=True