Vision par ordinateur (Édition Python)

---

Prérequis

• Ordinateur fixe ou portable, architecture de processeur x86/AMD64
• Système d'exploitation Linux
• Python 3.13.2

sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev tk-dev libncurses5-dev libncursesw5-dev

# Où

sudo dnf install gcc zlib-devel bzip2 bzip2-devel readline-devel \
sqlite sqlite-devel openssl-devel xz xz-devel libffi-devel \
findutils tk-devel ncurses-devel

curl -fsSL https://pyenv.run | bash

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init - bash)"' >> ~/.bashrc
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc

pyenv install 3.13.2
cd répertoire/du/projet
pyenv local 3.13.2

---

Créer un environnement virtuel Python.

python -m venv venv

Activer l'environnement virtuel au terminal courant.

source venv/bin/activate

Mettre à jour Pip (pour éviter les erreurs d'installation de librairies).

pip install --upgrade pip

Installer les librairies nécessaires au déroulement du programme.

pip install -r requirements.txt

Exécuter le dialogue d'aide sur le programme principale.

> python main.py --help
usage: main.py [-h] [-i INPUT] [-o OUTPUT] [-f] [-u API_URL] [-m MODELNAME] [-v]

options:
  -i, --input INPUT     Chemin vers la vidéo à lire ('0' est à utiliser pour la webcam par défaut)
  -o, --output OUTPUT   Emplacement pour enregistrer le processus dans une vidéo (Attention au RGPD, désactivé si aucun)
  -f, --force           Forcer le redimensionnement du flux d'entrée.
  -u, --api-url API_URL
                        Chemin réseau vers l'API (désactivé si aucun)
  -m, --model MODELNAME
                        Nom complet (ou chemin) du modèle de détection à utiliser
  -v, --verbose         Activer la sortie verbeuse du programme.

---

Démarrage automatique

Dans le répertoire source du projet, il y a un script bash permettant l'installation et le démarrage automatique. Il faut d'abord essayer le programme manuellement (avec les instructions précédentes). Si le programme est satisfaisant, le script d'auto-installation est pertinent.

Exécuter le script

./auto-install.sh

Le script propose quels paramètres sont à activer automatiquement (pour l'exécution à l'ouverture de la session)

> ./autoinstall.sh
Voulez-vous indiquer un flux d'entrée ? (oui/non): oui
Entrez la valeur d'entrée : 4
Voulez-vous une verbosité accrue ? (oui/non): non
Voulez-vous forcer le redimenssionnement de l'image ? (oui/non): oui
Voulez-vous renseigner l'URL de l'API ? (oui/non): oui
Entrez l'URL de l'API : http://localhost:1880

Redémarrer l'ordinateur hôte.

sudo reboot now

En cas d'erreurs ou de doutes, regarder la journalisation.

less ~/vision-par-ordinateur-python/main.log