Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
python:anaconda [2020/09/28 17:26] Francesco Beretta |
python:anaconda [2023/02/27 13:24] Francesco Beretta [Installation et activation de JupyterLab] |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
Retour à l'accueil [[python:accueil|Python pour les historiens]] | Retour à l'accueil [[python:accueil|Python pour les historiens]] | ||
- | ======= Installer et configurer son environnement Python ======= | + | ======= Installer et configurer son environnement de travail Python ======= |
- | ====== Documentation et tutoriels ====== | + | ===== Gestion de l'environnement de travail ===== |
- | ===== Anaconda/Miniconda ===== | + | [...] |
- | * [[https://www.anaconda.com/what-is-anaconda/|Ce qu'est Anaconda]] – [[https://docs.conda.io/projects/conda/en/latest/index.html|ce qu'est **Conda**]] | ||
- | * Installer [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]]. Dans le cadre de ce tutoriel, la version de python pouvant être utilisée est la **3.7**. | ||
- | * Quelle différence entre Anaconda et Miniconda ? [[https://www.anaconda.com/download/|Anaconda]] apporte, en plus du gestionnaire d'environnements Python //conda//, une interface graphique complète et différents logiciels. L'environnement risque d'être un peu lourd – pour des petits projets **Miniconda** est préférable. Il n'est pas recommandé, dans le cadre de cet atelier, de créer un environnement avec le logiciel Anaconda, car cela pose problème par la suite. | ||
- | * [[https://zestedesavoir.com/tutoriels/1448/installer-un-environnement-de-developpement-python-avec-conda|Tutoriel en français]] concernant l'utilisation de //conda//. | ||
- | * [[https://docs.conda.io/projects/conda/en/latest/user-guide/getting-started.html|Tutoriel en anglais]] de conda | ||
- | * **[[python:environnement_conda|Créer et gérer un environnement Conda]]** | ||
- | ===== JupyterLab git extension ===== | ||
- | Documentation concernant //JupyterLab git extension//: | + | ===== Gestion des environnements virtuels ===== |
- | * [[https://github.com/jupyterlab/jupyterlab-git|jupyterlab / jupyterlab-git]] | + | |
- | * Tutoriel [[https://annefou.github.io/jupyter_publish/02-git/index.html|JupyterLab git extension]] | + | |
- | * Un tutoriel très intéressant sur Jupyter Lab dont la partie 3 concerne GitHub: [[http://jakevdp.github.io/blog/2017/03/03/reproducible-data-analysis-in-jupyter/|Reproducible Data Analysis in Jupyter]] | + | |
- | **/!\ Avant de faire le tutoriel, réfléchissez si vous devez créer un nouveau environnement virtuel, si vous avez déjà d'autres projets en cours.** Il est donc préférable de créer un environnement en ligne de commande. Voir ci-dessous pour l'installation de l'environnement. | ||
- | \\ Une fois que vous avez activé votre environnement dans Miniconda, pensez à installer **JupyterLab**. Jupyter Notebook sera automatiquement installé avec. | ||
- | \\ Une fois JupyterLab installé, lancez le, il s'affichera sur votre navigateur. | ||
+ | Les environnements virtuels fournissent un moyen puissant pour isoler les paquets utilisés dans un projet utilisant Python et leurs dépendances. Cela signifie que vous pouvez utiliser des paquets particuliers à un projet sans les installer sur l’ensemble du système, en évitant ainsi les conflits de version potentiels et en assurant la cohérence de l'environnement. | ||
+ | Cf. [[https://docs.python.org/fr/3/tutorial/venv.html|Environnements virtuels et paquets]]. | ||
- | Les paquets pour conda: | + | Plusieurs outils de gestion d'environnements virtuels existent, construits autour de PIP (cf. documentation officielle de Python). Comme nous pratiquons ici une approche orientée analyse de données (et non développement web ou développement d'applications), nous avons privilégié le gestionnaire de paquets Conda (cf. ci-dessous), ainsi qu'un édrivé plus performant appelé [[https://mamba.readthedocs.io/en/latest/index.html|Mamba]]. |
- | * [[https://anaconda.org/conda-forge/jupyterlab-git|jupyterlab-git]] ([[https://github.com/jupyterlab/jupyterlab-git|documentation sur GitHub]]) | + | |
- | * [[https://anaconda.org/krinsman/jupyterlab-github|jupyterlab-github]] ([[https://github.com/jupyterlab/jupyterlab-github|Documentation sur Github]]) | + | |
- | ====== Installation de Miniconda avec JupyterLab et ses plugins ====== | + | Ces deux gestionnaires d'environnements permettent d'installer des paquets d'autres langages informatiques, tel R, node.js ou java. Il est donc particulièrement intéressant et fléxible pour notre but. |
+ | |||
+ | |||
+ | ====== Miniconda / Anaconda ====== | ||
+ | |||
+ | * [[https://www.anaconda.com/what-is-anaconda/|Ce qu'est Anaconda]] – [[https://docs.conda.io/projects/conda/en/latest/index.html|ce qu'est Conda]] | ||
+ | * **Installer [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]].** Dans le cadre de ce tutoriel, la version de python de référence est la **3.9**. | ||
+ | * Quelle différence entre Anaconda et Miniconda ? [[https://www.anaconda.com/download/|Anaconda]] apporte, en plus du gestionnaire d'environnements Python //conda//, une interface graphique complète et différents logiciels. L'environnement risque d'être un peu lourd – pour des petits projets **Miniconda** est préférable. Il n'est pas recommandé, dans le cadre de cet atelier, de créer un environnement avec le logiciel Anaconda, car cela pose problème par la suite. | ||
+ | * [[https://zestedesavoir.com/tutoriels/1448/installer-un-environnement-de-developpement-python-avec-conda|Tutoriel en français]] concernant l'utilisation de //conda//. | ||
+ | * [[https://docs.conda.io/projects/conda/en/latest/user-guide/getting-started.html|Tutoriel en anglais]] de conda | ||
+ | |||
+ | |||
+ | |||
+ | ===== Installation de Miniconda ===== | ||
**Miniconda est à préférer car c'est environnement beaucoup plus léger** (mais à utiliser en ligne de commande). | **Miniconda est à préférer car c'est environnement beaucoup plus léger** (mais à utiliser en ligne de commande). | ||
Ligne 37: | Ligne 37: | ||
* Télécharger [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] et installer en suivant les instructions de l'installateur. Sous Windows et Linux choisir la version adaptée au système : 32 ou 64 bits. | * Télécharger [[https://docs.conda.io/en/latest/miniconda.html|Miniconda]] et installer en suivant les instructions de l'installateur. Sous Windows et Linux choisir la version adaptée au système : 32 ou 64 bits. | ||
- | ===== Windows et macOS ===== | + | ===== Windows et MacOS ===== |
* Relever l'emplacement d'installation | * Relever l'emplacement d'installation | ||
* En général sous Windows C:\Users\[nom utilisateur]\Miniconda3 | * En général sous Windows C:\Users\[nom utilisateur]\Miniconda3 | ||
- | * Cocher : Conda comme installation Python par défaut | + | * Cocher : **Conda comme installation Python par défaut** |
- | * Cocher "Ajouter au PATH" ! | + | * **Ne pas cocher**: "Ajouter au PATH" ! |
- | * Si Conda n'est pas ajouté au PATH, utiliser le programme //Anaconda prompt// après installation. Si Conda n'est toujours pas visible, voir ci-dessous les Problèmes/bugs | + | * [Octobre 2020] L'installateur de Miniconda dans Windows 10 déconseille de l'ajouter au PATH, à cause de problèmes qui pourraient survenir. |
+ | * Dans le menu de démarrage Windows (Windows Start menu) sélectionner "Anaconda 64bit". L'ajout au PATH peut provoquer des problèmes. | ||
+ | * Conda n'est pas ajouté au PATH, utiliser le programme //Anaconda prompt// après installation. Si Conda n'est toujours pas visible, voir ci-dessous les Problèmes/bugs | ||
[[https://docs.conda.io/projects/conda/en/latest/user-guide/getting-started.html|Tutoriel]] d'introduction a l'utilisation de //conda// | [[https://docs.conda.io/projects/conda/en/latest/user-guide/getting-started.html|Tutoriel]] d'introduction a l'utilisation de //conda// | ||
+ | |||
+ | |||
+ | ===== Vérification de l'installation ===== | ||
+ | |||
| | ||
Sous Windows, lancer le programme //Anaconda prompt//, sous Mac ouvrir le //Terminal//: | Sous Windows, lancer le programme //Anaconda prompt//, sous Mac ouvrir le //Terminal//: | ||
- | * Vérifier l'installation de Conda en exécutant la commande ci-dessous qui donne la liste des paquets installés dans l'environnement de base: <code>conda list</code> | + | * Vérifier l'installation de Conda en exécutant la commande ci-dessous qui donne la version de conda: <code>conda info</code> |
+ | * la liste des paquets installés dans l'environnement de base: <code>conda list</code> | ||
+ | * la liste des environnements disponibles: <code>conda env list</code> | ||
+ | * Au début il n'y aura que l'nevironnement de 'base' | ||
+ | * Attention : n'installer aucun paquet dans l'environnement de base ! Toujours créer un nouvel environnement. | ||
* En cas d'erreur, si par exemple CMD (Windows) / Terminal (MacOS) renvoit le message d'erreur suivant <code>conda: command not found error</code> voir Problèmes / Bugs ci-dessous. | * En cas d'erreur, si par exemple CMD (Windows) / Terminal (MacOS) renvoit le message d'erreur suivant <code>conda: command not found error</code> voir Problèmes / Bugs ci-dessous. | ||
* Exécuter tout d'abord une mise à jour de Conda: <code>conda update conda</code> | * Exécuter tout d'abord une mise à jour de Conda: <code>conda update conda</code> | ||
* Lorsque l'exécutable imprime la liste des paquets à mettre à jour et demande: installer y/n ? répondre y = yes | * Lorsque l'exécutable imprime la liste des paquets à mettre à jour et demande: installer y/n ? répondre y = yes | ||
+ | |||
+ | |||
+ | |||
+ | ===== Gérer un environnement avec Conda ===== | ||
+ | |||
+ | |||
+ | \\ | ||
+ | Pages dédiées dans ce Wiki: | ||
+ | |||
+ | * [[intro_histoire_numerique:conda_histoire_numerique|Environnement pour le cours histoire numérique]] | ||
+ | * [[python:environnement_conda|Créer et gérer un environnement Conda]] (dans ce tutoriel Python) | ||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====== Installation de JupyterLab ====== | ||
+ | |||
+ | |||
+ | ===== Ajout du canal conda-forge et installation de Mamba ===== | ||
+ | |||
+ | |||
* Lister les environnemnents disponibles <code>conda env list</code> | * Lister les environnemnents disponibles <code>conda env list</code> | ||
- | * Créer ensuite un environnement contenant Jupyter Lab: conda create --name <envname> python=<version>. | + | * Ajouter le canal 'conda-forge' : <code>conda config --add channels conda-forge</code> |
- | * <code> [suggestion:] conda create --name py37_gitlab python=3.7 jupyterlab=1.2.7 jupyterlab-git </code> | + | * Vérifier l'ajout du canal <code>conda info</code>: apparait la liste des canaux |
- | * Pour Windows taper: <code>conda create --name py37_gitlab python=3.7 jupyterlab pywin32 jupyterlab-git jupyterlab-github requests</code> | + | * Vérifier la liste des canaux prioritaires: <code>conda config --show channels</code> doit donner comme résultat: |
- | * Lorsque l'exécutable demande : installer y/n répondre y = yes | + | <code>channels: |
- | * Activer le nouvel environnement : <code>conda activate py37_gitlab</code> | + | - conda-forge |
+ | - defaults | ||
+ | </code> | ||
+ | * Si l'ordre est inversé, effectuer: <code>conda config --set channel_priority strict</code>, puis vérifier l'ordre des canaux avec <code>conda config --show channels</code> 'conda-forge' doit être en premier. | ||
+ | |||
+ | * Installation de Mamba dans l'environnement de base de Conda: <code>conda install mamba -n base</code> | ||
+ | * Une mise à jour de beaucoup de paquets est effectuée | ||
+ | * Test de l'installation de Mamba: | ||
+ | * <code>mamba info</code> | ||
+ | * <code>conda list</code>, cf. le paquet mamba. | ||
+ | * Cf. la [[https://mamba.readthedocs.io/en/latest/user_guide/mamba.html|documentation de Mamba]] | ||
+ | ===== Installation et activation de JupyterLab ===== | ||
+ | |||
+ | Afin de disposer d'une installation propre de Jupyterlab on va créer un environnement conda qui lui est dédié et dans lequel on n'installera pas d'autres librairies. Afin d'effectuer des analyses de données ou autres traitements, on crééera ensuite des environnements Conda appropriés qu'on activera dans Jupyterlab. | ||
+ | |||
+ | |||
+ | * Avant toute nouvelle installation: <code>mamba update mamba</code> | ||
+ | * Créer ensuite un environnement contenant Jupyter Lab. Voici la syntaxe à utiliser, on l'appliquera selon les exemples ci-dessous : <code>mamba create --name <envname> python=<version></code>. | ||
+ | * Pour **MacOS** et **Windows 64 bits** exécuter: <code>mamba create --name env_jupyterlab python=3.10 jupyterlab</code> | ||
+ | * Pour **Windows** la **même chose**, sauf si système à 32-bit: | ||
+ | * Si système à 32 bits exécuter: <code>mamba create --name env_jupyterlab python=3.10 jupyterlab pywin32</code> | ||
+ | |||
+ | * Lorsque l'exécutable demande : installer Y/n répondre Y = yes | ||
+ | * Lister les environnemnents disponibles: <code>conda env list</code> | ||
+ | |||
+ | * To remove an environment, in your terminal window or an Anaconda Prompt, run: | ||
+ | <code>conda remove --name myenv --all</code> | ||
+ | |||
+ | |||
+ | |||
+ | * Activer le nouvel environnement : <code>conda activate env_jupyterlab</code> | ||
+ | * Pour désactiver l'environnement et revenir à l'environnement 'base: <code>conda deactivate</code> | ||
+ | * Déplacer la position du Terminal vers le dossier dans lequel on mettra les notebooks (et les sous-dossiers des projets Github):<code>cd /root/folder/dossier_python/</code> Syntaxe Windows:<code>cd C:\Users\My_Name\Documents\dossier_python</code> | ||
+ | |||
* Démarrer Juypter Lab : <code>jupyter lab</code> | * Démarrer Juypter Lab : <code>jupyter lab</code> | ||
- | * Si on veut ajouter des nouveau paquets à l'environnement, arrêter Jupyter Lab (alt-C pour Windows ou ctrl-C pour Mac), puis ajouter les paquets à l'environnement actif, dans ce cas //py37_gitlab// puis relancer le Lab. | + | * Pour **arrêter Jupyter Lab**: taper dans le Terminal ou Prompt où il est actif **alt-C** pour Windows ou **ctrl-C** pour Mac. |
- | * Pour utiliser différents environnements, dédiés à différents projets ou technologies (NLP, etc.) voir les [[python:environnement_conda&#creer_un_nouvel_environnement_atelier_et_l_ajouter_aux_kernels_de_jupyter_lab|instructions sur cette page]] | + | * En cas de problèmes avec l'antivirus (surréaction et annonce de virus [[https://justuto.com/idp-generic-virus/|voir cette page]]) |
+ | * Si on veut ajouter des nouveau paquets à l'environnement, **arrêter Jupyter Lab** , puis ajouter les paquets à l'environnement actif, dans ce cas //py37_gitlab// puis relancer le Lab. | ||
+ | * ATTENTION: mieux vaut toutefois garder l'environnement 'env_jupyterlab' uniquement pour JupyterLab et ses extentions. | ||
+ | * Pour l'analyse de données, créer des environnements dédiés à différents projets ou technologies (NLP, etc.) qui seront activés dans jupyterlab. **voir les [[python:environnement_conda&#creer_un_nouvel_environnement_atelier_et_l_ajouter_aux_kernels_de_jupyter_lab|instructions sur cette page]]** | ||
\\ | \\ | ||
- | \\ | + | -------------- |
- | -------- | + | |
- | ==== Problèmes / Bugs ==== | + | |
- | Voir les [[python:bugs_connus_conda|Problèmes / Bugs]] connus concernant l'installation de Miniconda ou de ses plugins | + | ====== Utilisateurs avancés – Plugins de JupyterLab ====== |
- | ====== Configuration des plugins JupyterLab ====== | + | |
+ | ATTENTION : l'installation de ce qui suit __n'est pas nécessaire__ (à éviter pour les utilisateurs·trices non expérimenté·e·s). | ||
+ | |||
+ | \\ | ||
===== Plugin jupyterlab-github ===== | ===== Plugin jupyterlab-github ===== | ||
- | Sur l'interface JupyterLab, à gauche vous avez une barre de menu. Cliquez sur l'icône Puzzle "**Extension Manager**" (gestionnaire des plugins). | + | |
+ | * Documentation [[https://github.com/jupyterlab/jupyterlab-github|JupyterLab GitHub]]. | ||
+ | * **Arrêter Jupyter Lab** (dans le Terminal ou Prompt où il est actif taper **alt-C** pour Windows ou **ctrl-C** pour Mac). | ||
+ | * Vérifier qu'on est bien dans l'environnement 'py37_jupyterlab' | ||
+ | * Exécuter: <code>conda install -c conda-forge nodejs</code> | ||
+ | * Exécuter: <code> jupyter labextension install @jupyterlab/github</code> | ||
+ | * Démarrer Juypter Lab : <code>jupyter lab</code> | ||
+ | |||
+ | |||
+ | Sur l'interface JupyterLab, à gauche vous avez une barre de menu. | ||
+ | \\ | ||
+ | Cliquez sur l'icône Puzzle "**Extension Manager**" (gestionnaire des plugins). Un message de sécurité indique que les Plugins (extensions) de JupyterLab sont produits par la commuanté et que donc il peut y avoir des risques de sécurité. C'est bon à savoir mais il faut tout de même répondre: OUI. | ||
+ | |||
Dans la barre de recherche, cherchez "**github**". Le plugin qui nous intéresse est celui-ci : | Dans la barre de recherche, cherchez "**github**". Le plugin qui nous intéresse est celui-ci : | ||
Ligne 84: | Ligne 174: | ||
Dans le cadre de l'atelier Données FAIR (FAIR Data), nous pouvons par exemple utiliser **atterebf** comme nom d'utilisateur. Une liste de dépôt github s'affiche, sélectionnez **atelier_arhn**, puis **import_csv_xls**, et enfin le carnet jupyter **import_csv.ipynb** (qui est en lecture seule). | Dans le cadre de l'atelier Données FAIR (FAIR Data), nous pouvons par exemple utiliser **atterebf** comme nom d'utilisateur. Une liste de dépôt github s'affiche, sélectionnez **atelier_arhn**, puis **import_csv_xls**, et enfin le carnet jupyter **import_csv.ipynb** (qui est en lecture seule). | ||
+ | |||
+ | \\ | ||
===== Plugin jupyterlab-git ===== | ===== Plugin jupyterlab-git ===== | ||
Ligne 102: | Ligne 194: | ||
Plus haut vous pouvez aussi constater "Current Repository", "Current Branch" qui vous permettra de gérer les branches. | Plus haut vous pouvez aussi constater "Current Repository", "Current Branch" qui vous permettra de gérer les branches. | ||
+ | |||
+ | -------- | ||
+ | |||
+ | \\ | ||
+ | |||
+ | ===== JupyterLab git extension ===== | ||
+ | |||
+ | |||
+ | jupyterlab-git | ||
+ | |||
+ | jupyterlab-git jupyterlab-github | ||
+ | |||
+ | |||
+ | Documentation concernant //JupyterLab git extension//: | ||
+ | * [[https://github.com/jupyterlab/jupyterlab-git|jupyterlab / jupyterlab-git]] | ||
+ | * Tutoriel [[https://annefou.github.io/jupyter_publish/02-git/index.html|JupyterLab git extension]] | ||
+ | * Un tutoriel très intéressant sur Jupyter Lab dont la partie 3 concerne GitHub: [[http://jakevdp.github.io/blog/2017/03/03/reproducible-data-analysis-in-jupyter/|Reproducible Data Analysis in Jupyter]] | ||
+ | |||
+ | **/!\ Avant de faire le tutoriel, réfléchissez si vous devez créer un nouveau environnement virtuel, si vous avez déjà d'autres projets en cours.** Il est donc préférable de créer un environnement en ligne de commande. Voir ci-dessous pour l'installation de l'environnement. | ||
+ | \\ Une fois que vous avez activé votre environnement dans Miniconda, pensez à installer **JupyterLab**. Jupyter Notebook sera automatiquement installé avec. | ||
+ | \\ Une fois JupyterLab installé, lancez le, il s'affichera sur votre navigateur. | ||
+ | |||
+ | |||
+ | Les paquets pour conda: | ||
+ | * [[https://anaconda.org/conda-forge/jupyterlab-git|jupyterlab-git]] ([[https://github.com/jupyterlab/jupyterlab-git|documentation sur GitHub]]) | ||
+ | * [[https://anaconda.org/krinsman/jupyterlab-github|jupyterlab-github]] ([[https://github.com/jupyterlab/jupyterlab-github|Documentation sur Github]]) | ||
+ | |||
+ | |||
+ | |||
+ | \\ | ||
+ | ====== Problèmes / Bugs ====== | ||
+ | |||
+ | Voir les [[python:bugs_connus_conda|Problèmes / Bugs]] connus concernant l'installation de Miniconda, JupyterLab et ses plugins |