Getting started

PQSetup is currently a pre-release project installed from source. The graphical interface and its static assets are included in the Python package.

Requirements

  • Python 3.11 or newer

  • A PQ executable to validate and run the generated inputs

  • The calculator and supporting files required by the chosen method

You can design and export portable inputs without a detected calculator or PQ executable. PQSetup reports the missing checks instead of silently passing them.

Install

git clone https://github.com/MolarVerse/PQSetup.git
cd PQSetup
python3 -m venv .venv
source .venv/bin/activate
python -m pip install .

Node.js is only needed when changing the interface.

Check the environment

pqsetup doctor

doctor reports the selected PQ executable and the external calculators that PQSetup can detect. To use a different executable:

pqsetup --pq-executable /opt/pq/bin/PQ doctor

The same path can be supplied through PQ_EXECUTABLE.

Open the interface

pqsetup

PQSetup opens a local page at 127.0.0.1:8888. To choose another port or avoid opening a browser:

pqsetup serve --port 8890 --no-browser

Create the first package

  1. Import a structure, or keep the water example.

  2. Choose molecular mechanics or one QM calculator.

  3. Set the sampling ensemble and duration. Add NVT equilibration if needed.

  4. Review optional coordinate preparation.

  5. Inspect every generated input, then create the package.

Presets are editable starting points, not validated production protocols. Check the timestep, duration, coupling constants, method, and system size for the actual scientific question.

Run the package

Unpack the download on the machine where PQ and the calculator are available:

mkdir water-nvt
unzip water-nvt.zip -d water-nvt
cd water-nvt
./run.sh /opt/pq/bin/PQ

The launcher follows the recorded input order, writes output to run-logs/, and stops after the first failed or incomplete PQ run.

PQSetup does not submit a scheduler job. Transfer and submission remain under the user’s control.

Next