Creating a Linux installation and uninstallation script - Ubuntu & Fedora

[BRUNEXX13]

Add environment setup and cleanup scripts

Benefit: Install more easy and secure #!!

I put the script on my github, you can use if you want: https://github.com/BRUNEXX13/turing-smart-screen

Problem:
Setting up the Python environment for this project requires multiple manual steps: installing system dependencies, Python packages with exact versions, creating a virtual environment, and running configure.py. Cleanup is also cumbersome.

Solution:
Add automated scripts for environment management:

install_env.sh – Installs system dependencies, creates virtual environment, installs Python packages, and runs configure.py.

uninstall_env.sh – Removes virtual environment, Python packages, and system development libraries.

uninstall_env_safe.sh – Removes only the virtual environment and Python packages inside it, leaving system packages untouched.

Key Features:

Works on Ubuntu/Debian and Fedora/RHEL/CentOS

Force-reinstalls critical Python packages (ruamel.yaml, Pillow, GPUtil) to prevent import errors

Automatically activates the virtual environment at the end of setup

Alternatives Tested:
Manual installation of dependencies using apt/dnf and pip. Error-prone, time-consuming, and not reproducible.

Environment:

Branch: main

OS: Ubuntu 22.04 / Fedora 38

Python: 3.13

Hardware: Intel/AMD CPU, NVIDIA GPU, Raspberry Pi 5

Additional context:
These scripts streamline setup, reduce errors, and improve onboarding for new contributors.

Tags: scripts, setup, python, environment, automation

[BRUNEXX13]

`#!/bin/bash

============================================================

🧠 Python Environment Setup Script (Multi-Distro, Full)

Author: Bruno (Refined by Gemini)

============================================================

set -e # stop on any error

------------------------------------------------------------

1️⃣ Detect Linux distribution

------------------------------------------------------------

if [ -f /etc/os-release ]; then
. /etc/os-release
DISTRO=$ID
else
echo "❌ Could not detect Linux distribution. Exiting."
exit 1
fi

case "$DISTRO" in
ubuntu|debian)
PKG_MANAGER="apt"
PY_DEV="python3-dev"
DRM_DEV="libdrm-dev"
UPDATE_CMD="sudo apt update || true" # Simplified update command
INSTALL_CMD="sudo apt install -y"
;;
fedora|rhel|centos|rocky|alma)
PKG_MANAGER="dnf"
PY_DEV="python3-devel"
DRM_DEV="libdrm-devel"
UPDATE_CMD="sudo dnf check-update || true"
INSTALL_CMD="sudo dnf install -y"
;;
*)
echo "⚠️ Unsupported distribution: $DISTRO"
exit 1
;;
esac

echo "✅ Detected distribution: $DISTRO"

------------------------------------------------------------

2️⃣ Update system package list

------------------------------------------------------------

echo "🔄 Updating system package list..."
eval "$UPDATE_CMD"

------------------------------------------------------------

3️⃣ Install dependencies

------------------------------------------------------------

echo "📦 Installing system dependencies..."
if [ "$PKG_MANAGER" = "apt" ]; then
$INSTALL_CMD python3 python3-pip python3-venv python3-tk $PY_DEV build-essential $DRM_DEV
libjpeg-dev libpng-dev libtiff-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev
tcl-dev tk-dev libffi-dev libssl-dev
else
$INSTALL_CMD python3 python3-pip python3-venv python3-tk $PY_DEV $DRM_DEV
libjpeg-turbo-devel libpng-devel libtiff-devel zlib-devel freetype-devel lcms2-devel libwebp-devel
tcl-devel tk-devel libffi-devel openssl-devel
fi

------------------------------------------------------------

4️⃣ Create and activate virtual environment

------------------------------------------------------------

echo "🐍 Creating virtual environment in ./venv..."
python3 -m venv venv

echo "🔌 Activating virtual environment for the duration of this script..."

A linha abaixo ativa o venv para que os comandos 'pip' a seguir

instalem os pacotes dentro do ambiente isolado.

source venv/bin/activate

------------------------------------------------------------

5️⃣ Create requirements.txt

------------------------------------------------------------

echo "📝 Generating requirements.txt..."
cat < requirements.txt
pyserial==3.5
PyYAML==6.0.2
psutil==7.0.0
pystray==0.19.5
babel==2.17.0
ruamel.yaml==0.18.10
sv-ttk==2.6.0
tkinter-tooltip==3.1.2
uptime==3.0.1
requests==2.32.3
ping3==4.0.8
pyinstaller==6.13.0
Pillow==11.2.1
GPUtil==1.4.0
EOF

------------------------------------------------------------

6️⃣ Upgrade pip and install Python packages

------------------------------------------------------------

echo "⚙️ Upgrading pip and installing Python packages..."
pip install --upgrade pip
pip install --force-reinstall -r requirements.txt

------------------------------------------------------------

7️⃣ Verify installed packages

------------------------------------------------------------

echo "✅ Verifying installed packages..."
pip list | grep -E "pyserial|PyYAML|psutil|pystray|babel|ruamel|sv-ttk|tkinter-tooltip|uptime|requests|ping3|pyinstaller|Pillow|GPUtil"

------------------------------------------------------------

8️⃣ Run configure.py automatically

------------------------------------------------------------

if [ -f "configure.py" ]; then
echo "⚡ Running configure.py..."
python3 configure.py
echo "✅ configure.py executed successfully!"
else
echo "⚠️ configure.py not found, skipping."
fi

------------------------------------------------------------

9️⃣ Final message

------------------------------------------------------------

echo ""
echo "🎉 Environment successfully configured!"
echo "✅ All packages were installed inside the './venv' directory."
echo ""
echo "👉 IMPORTANTE: Para trabalhar no seu projeto, você DEVE ativar o ambiente manualmente em seu terminal com o comando:"
echo " source venv/bin/activate"
echo ""
`

[BRUNEXX13]

`#!/bin/bash

===================================================================

🗑️ Turing Smart Screen Uninstallation Script

This script will:

1. Stop and disable the systemd service.

2. Remove the systemd service file.

3. Securely remove the application directory.

Author: Bruno (Created with Gemini)

===================================================================

set -e # Stop on any error

--- Configuration ---

⚠️ IMPORTANT: Please verify these variables match your setup!

SERVICE_NAME="turing-smart-screen.service"
PROJECT_DIR="/opt/turing-smart-screen-python" # The main directory of your application

--- End of Configuration ---

SERVICE_FILE="/etc/systemd/system/$SERVICE_NAME"

echo "Uninstalling Turing Smart Screen..."
echo "-------------------------------------"

------------------------------------------------------------

1️⃣ Stop and Disable the Systemd Service

------------------------------------------------------------

echo "🛑 Stopping and disabling the systemd service..."
if systemctl is-active --quiet "$SERVICE_NAME"; then
sudo systemctl stop "$SERVICE_NAME"
echo "Service stopped."
else
echo "Service was not running."
fi

if systemctl is-enabled --quiet "$SERVICE_NAME"; then
sudo systemctl disable "$SERVICE_NAME"
echo "Service disabled from startup."
else
echo "Service was not enabled."
fi

------------------------------------------------------------

2️⃣ Remove the Systemd Service File

------------------------------------------------------------

echo "🚮 Removing the systemd service file..."
if [ -f "$SERVICE_FILE" ]; then
sudo rm -f "$SERVICE_FILE"
sudo systemctl daemon-reload
echo "✅ Service file removed and systemd reloaded."
else
echo "⚠️ Service file not found, skipping."
fi

------------------------------------------------------------

3️⃣ Remove the Project Directory

------------------------------------------------------------

echo "🔥 Preparing to delete the project directory: $PROJECT_DIR"
echo " This action is IRREVERSIBLE and will delete the venv, scripts, and all configurations."
echo ""

read -p "Are you absolutely sure you want to delete this directory? [y/N] " response
if [[ "$response" =~ ^[Yy]$ ]]; then
if [ -d "$PROJECT_DIR" ]; then
echo "Deleting directory: $PROJECT_DIR..."
sudo rm -rf "$PROJECT_DIR"
echo "✅ Project directory successfully deleted."
else
echo "⚠️ Project directory not found, skipping."
fi
else
echo "Deletion aborted by user. The project directory has NOT been removed."
exit 0
fi

------------------------------------------------------------

4️⃣ Optional Cleanup Suggestion

------------------------------------------------------------

echo ""
echo "💡 Optional Cleanup: System Dependencies"
echo "The setup script installed some system packages (like python3-dev, libjpeg-dev, etc.)."
echo "These are NOT removed automatically, as they might be used by other applications."
echo "If you are sure you no longer need them, you can run a command like 'sudo apt autoremove' to clean up unused packages."

------------------------------------------------------------

5️⃣ Final Message

------------------------------------------------------------

echo ""
echo "🎉 Uninstallation complete!"
echo "The Turing Smart Screen service and application files have been removed."
`

[BRUNEXX13]

[Unit]
Description=Turing Smart Screen
Requires=network-online.target
After=network-online.target

[Service]
Type=simple

Check if this is your correct user!

User=YOUR_USERNAME

Check if this is the correct path for your project!

WorkingDirectory=/opt/turing-smart-screen-python/

Full path to the venv's Python, followed by the script to be executed

ExecStart=/opt/turing-smart-screen-python/venv/bin/python3 main.py

Restart=always

ProtectSystem=full
ProtectHome=read-only
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=multi-user.target

[BRUNEXX13]

@mathoudebine This will be useful for most people, what do you think?