Quickstart

Goal: Start QGas locally and open the interactive map.

Prerequisites

• Python 3.11+
• Modern browser (the manual recommends Microsoft Edge)
• Local port 8000 must be available

1) Install Environment

The project includes a Conda definition: environment.yml.

Option A: Manual Setup

conda env create -f environment.yml
conda activate QGas

Option B: Automated Setup (Recommended for Non-Programmers)

For users who prefer a simplified setup, use the Conda-Activation-Scripts. This repository provides easy-to-use scripts that automatically create and activate the environment:

• Repository: https://github.com/IEE-TUGraz/Conda-Activation-Scripts
• The scripts handle environment creation and activation with a single click
• Ideal for users unfamiliar with command-line tools

See the Conda-Activation-Scripts/ folder in the project root for included scripts.

2) Start QGas GUI

python Server.py

3) Select Project, Start Server

• In the GUI, select a project from the Input/ folder
• Start the server (GUI controls the web server)

4) Open Interactive Map

• http://localhost:8000/GUI.html

If a contributor dialog appears: create a new contributor or select an existing one.