Étape 1 : Préparation de l'Environnement Python⚓︎

Avant de pouvoir coder notre application OpenFoodFacts et d'utiliser efficacement notre assistant IA, nous devons nous assurer que Python est correctement installé sur votre machine et que nous savons comment créer un environnement de travail propre pour notre projet.

Pour Commencer (Instructions Simples)⚓︎

1. Vérifier si Python est Installé⚓︎

Ouvrez un terminal (ou invite de commandes) et tapez :

Bash

python --version
# ou si cela ne fonctionne pas, essayez :
python3 --version

Si une version s'affiche (par exemple, Python 3.9.5), Python est déjà installé. Passez à l'étape "Créer un Environnement Virtuel". Sinon, continuez ci-dessous.

2. Installer Python (si nécessaire)⚓︎

Rendez-vous sur python.org/downloads/ et téléchargez la dernière version stable de Python pour votre système d'exploitation (Windows, macOS, Linux).

Windows : Exécutez l'installeur. Important : Cochez la case "Add Python to PATH" ou "Ajouter Python à PATH" lors de l'installation.
macOS : Utilisez l'installeur téléchargé. Python est souvent pré-installé, mais il est bon d'avoir une version récente.
Linux : Python est généralement pré-installé. Si vous devez l'installer ou le mettre à jour, utilisez le gestionnaire de paquets de votre distribution (par exemple, sudo apt update && sudo apt install python3 sur Debian/Ubuntu).

Après l'installation, fermez et rouvrez votre terminal, puis réessayez python3 --version.

3. Créer un Dossier pour le Projet⚓︎

Créez un dossier sur votre ordinateur où vivra votre projet OpenFoodFacts. Par exemple, ExplorateurOpenFoodFacts.

4. Créer un Environnement Virtuel⚓︎

Un environnement virtuel isole les dépendances de votre projet. C'est une bonne pratique essentielle. Dans votre terminal, naviguez jusqu'au dossier de votre projet (cd chemin/vers/ExplorateurOpenFoodFacts) et tapez :

Bash

python3 -m venv .venv

Cela crée un sous-dossier .venv contenant une copie de Python et de ses outils.

5. Activer l'Environnement Virtuel⚓︎

Windows (Invite de Commandes) :
Bash
```
.venv\\Scripts\\activate.bat
```
Windows (PowerShell) :
Bash
```
.venv\\Scripts\\Activate.ps1
```
(Si vous avez une erreur de script, tapez Set-ExecutionPolicy Unrestricted -Scope Process puis réessayez, et ensuite Set-ExecutionPolicy Restricted -Scope Process pour restaurer la sécurité).
macOS / Linux (Bash/Zsh) :
Bash
```
source .venv/bin/activate
```
Une fois activé, le nom de l'environnement (.venv) devrait apparaître au début de votre invite de terminal.

Vous êtes prêt pour l'étape suivante ! Pour désactiver l'environnement virtuel plus tard, tapez simplement deactivate.

Pour Aller Plus Loin (Détails et Options Avancées)⚓︎

Pourquoi Python ?⚓︎

Python est un langage populaire, lisible, et dispose d'une vaste collection de bibliothèques, ce qui le rend idéal pour interagir avec des API web comme OpenFoodFacts et pour de nombreux projets d'IA.

Gestionnaires de Versions Python (pyenv)⚓︎

Si vous travaillez sur plusieurs projets nécessitant différentes versions de Python, des outils comme pyenv (pour macOS/Linux) ou pyenv-win (pour Windows) sont extrêmement utiles. Ils vous permettent d'installer et de basculer facilement entre plusieurs versions de Python sans conflit.

pyenv : https://github.com/pyenv/pyenv
pyenv-win : https://github.com/pyenv-win/pyenv-win L'installation de pyenv se fait généralement via un script ou Homebrew (macOS). Une fois installé, vous pouvez faire pyenv install 3.10.4 (par exemple) puis pyenv global 3.10.4 pour définir la version par défaut, ou pyenv local 3.10.4 pour un projet spécifique (crée un fichier .python-version).

Comprendre les Environnements Virtuels (`venv`)⚓︎

Le module venv est intégré à Python depuis la version 3.3. Il crée un environnement isolé en copiant (ou en liant symboliquement) l'interpréteur Python et certains outils dans un dossier (par convention, .venv). Lorsque vous installez des paquets avec pip alors que l'environnement est activé, ils sont installés dans le dossier .venv/lib/pythonX.Y/site-packages/ de cet environnement, et non globalement sur votre système.

Avantages :
- Isolation des dépendances : Chaque projet peut avoir ses propres versions de paquets sans conflit.
- Reproductibilité : Vous pouvez facilement recréer l'environnement sur une autre machine en utilisant un fichier requirements.txt (généré avec pip freeze > requirements.txt).
- Propreté du système : Évite de polluer l'installation Python globale de votre système.
Nom du dossier : .venv est une convention courante. Le . au début le rend caché sur les systèmes Unix. D'autres noms comme env ou venv sont aussi utilisés. L'important est d'être cohérent et d'ajouter ce nom à votre fichier .gitignore pour ne pas le versionner.

`pip` : Le Gestionnaire de Paquets Python⚓︎

pip est l'outil standard pour installer et gérer les paquets Python. Lorsque votre environnement virtuel est activé, pip installe les paquets dans cet environnement.

Installer un paquet : pip install nomdupaquet
Installer une version spécifique : pip install nomdupaquet==1.2.3
Mettre à jour un paquet : pip install --upgrade nomdupaquet
Lister les paquets installés : pip list
Désinstaller un paquet : pip uninstall nomdupaquet

Fichier `requirements.txt`⚓︎

Pour partager votre projet et permettre à d'autres (ou à vous-même sur une autre machine) de recréer facilement l'environnement avec les bonnes dépendances :

Activez votre environnement virtuel.
Générez le fichier : pip freeze > requirements.txt
Pour installer les dépendances à partir de ce fichier : pip install -r requirements.txt

N'oubliez pas d'activer votre environnement virtuel (source .venv/bin/activate ou équivalent) chaque fois que vous travaillez sur votre projet dans un nouveau terminal.