A. GNU/Linux Debian and Derived Distributions
To ensure the utilities work on Debian, your system should have Python3, pip, and python3-venv installed. You can install these programs using the terminal or a package manager like Synaptic.
First, check if Python and pip are already installed:
Bash
python3 --version
pip3 --version
If they are not installed, or if the versions are not appropriate, proceed with installing the following tools, including the Qt development version needed for the project.
Bash
sudo apt update
sudo apt install python3 python3-pip python3-venv
sudo apt install qt6-base-dev libqt6core6 libqt6gui6 libqt6widgets6 libqt6dbus6
After installing the packages, it’s advisable to restart your computer to ensure the changes are applied correctly.
When you open the terminal again, the python command might not work directly, but the python3 command will. To avoid having to type python3 all the time, you can create an alias. This will make your system understand python as a synonym for python3.
Bash
nano ~/.bashrc
and add
alias python='python3'
(to save Ctrl+o and to exit Ctrl+x)
To ensure this alias remains every time you open the terminal, you’ll need to add it to your shell configuration file (.bashrc or .zshrc, for example).
B. MS Windows
Python Installation
To ensure Piztu utilities work correctly, you must install the following programs on your computer, if you don’t already have them. Don’t worry if you’re not familiar with them, they are necessary tools for Piztu to run its scripts.
- Python To download Python, simply go to the official website. At this moment, the latest stable version is 3.13.5, but there might be more recent versions available.https://www.python.org/downloads/Note: During installation, it is very important to check the box “Add python.exe to PATH”. This option allows the system to find and use Python automatically. If you don’t check it, the Piztu utilities will not work correctly.

If we click on Customize installation, we’ll get the following view:

After installing the program, you should restart your computer. Next, check the installed Python version to confirm that the installation was successful.
python --version
Python 3.13.5
pip --version
pip 25.1.1 from C:\Program Files\Python313\Lib\site-packages\pip (python 3.13)
2. Visual C++ Redistributable Packages
Finally, we will also need to install a small utility for Windows
https://www.microsoft.com/en-us/download/details.aspx?id=40784

