Step 1. Prerequisites for Installation

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.

  1. 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

Scroll to Top