Préparer sa machine

Dans ce cours, chaque projet Python est géré par uv : c’est lui qui installe Python, crée l’environnement du projet (le dossier .venv) et y ajoute les bibliothèques. Beaucoup d’entre vous ont déjà installé Anaconda ou Miniconda pour un autre cours. Or conda modifie votre terminal pour qu’il démarre dans son propre Python, et ce Python passe alors devant celui de uv. Les symptômes typiques : un (base) au début de chaque ligne du terminal, un import pygame qui échoue alors que l’installation s’est bien passée, ou VS Code qui choisit le “mauvais” Python.

Cette page vous explique comment remettre les choses d’aplomb avant la séance 1. Comptez dix minutes. Si vous n’avez jamais installé conda, passez directement à la section Installer uv.

💡 Rien ne vous oblige à désinstaller conda : si vous en avez besoin ailleurs, il suffit qu’il ne s’active plus tout seul (cf. Option 1).

Ai-je conda, et est-il actif ?

Ouvrez un terminal (Terminal sur Mac et Linux, PowerShell sur Windows) et tapez :

conda --version

command not found (ou « n’est pas reconnu » sous Windows) : conda n’est pas là, ou du moins pas actif. Vérifiez tout de même le diagnostic à la fin.
Un numéro de version s’affiche : conda est installé et branché sur votre terminal. Si en plus votre invite commence par (base), il s’active à chaque ouverture du terminal, et c’est précisément ce qu’il faut éviter.

Ce que fait `conda init`, en clair

À l’installation (ou quand on tape conda init), conda ajoute un bloc de lignes dans le fichier de démarrage de votre terminal :

~/.zshrc sur Mac (le terminal par défaut est zsh) ;
~/.bashrc sur Linux, ou dans Git Bash sous Windows ;
votre profil PowerShell sous Windows (le chemin s’affiche avec echo $PROFILE).

Ce bloc est encadré par deux lignes repérables :

# >>> conda initialize >>>
...
# <<< conda initialize <<<

(sous PowerShell : #region conda initialize … #endregion). À chaque ouverture du terminal, ce bloc ajoute le dossier de conda en tête du PATH, c-à-d. la liste des dossiers où le terminal cherche les commandes, dans l’ordre. Le premier python trouvé gagne : c’est donc celui de conda. Enfin, le réglage auto_activate_base (renommé auto_activate dans les versions récentes) active l’environnement base dans la foulée, d’où le (base).

⚠️ Si vous avez lancé l’installeur ou conda init plusieurs fois, le bloc peut apparaître en double. Comptez-les avec grep -c "conda initialize" ~/.zshrc ~/.bashrc.

Option 1 : garder conda, mais le rendre discret

C’est l’option que je vous recommande si vous vous servez de conda dans un autre cours. Tapez :

conda config --set auto_activate_base false

Sur une version récente de conda, cette commande peut afficher un avertissement de dépréciation ; tapez alors aussi conda config --set auto_activate false. Fermez le terminal, rouvrez-en un : le (base) doit avoir disparu.

Concrètement, conda reste disponible, mais il ne prend plus la main tout seul. Le jour où vous en avez besoin, conda activate base le rallume dans ce terminal seulement, et conda deactivate l’éteint.

⚠️ Avant de travailler sur un projet du cours, vérifiez que votre invite ne commence pas par (base) ou par un autre nom d’environnement conda. Si c’est le cas, tapez conda deactivate (au besoin plusieurs fois, jusqu’à ce que le préfixe disparaisse).

Option 2 : désinstaller conda proprement

Si vous ne vous en servez plus, autant le retirer. L’ordre compte : on débranche d’abord conda du terminal, puis on supprime ses fichiers. Dans le cas contraire, le bloc conda initialize resterait dans vos fichiers de démarrage et chercherait un dossier qui n’existe plus.

Mac et Linux

conda init --reverse --all      # retire les blocs conda des fichiers de démarrage
conda info --base               # affiche le dossier d'installation, ex. /Users/vous/miniconda3

Fermez le terminal, rouvrez-en un, puis supprimez le dossier affiché par la deuxième commande ainsi que les fichiers de configuration de conda :

rm -rf ~/miniconda3             # ou ~/anaconda3, ~/opt/anaconda3 : le dossier vu plus haut
rm -rf ~/.condarc ~/.conda ~/.continuum

💡 Sur Mac, si vous aviez installé Anaconda via Homebrew, brew uninstall --cask anaconda (ou miniconda) remplace la suppression du dossier. Si l’installation est dans /opt/anaconda3, il faudra préfixer rm par sudo.

Windows

Ouvrez « Anaconda Prompt » depuis le menu Démarrer et tapez conda init --reverse --all.
Ouvrez Paramètres → Applications, cherchez « Anaconda » ou « Miniconda », puis cliquez sur Désinstaller.
Supprimez, s’ils existent encore, les dossiers C:\Users\VOUS\anaconda3 (ou miniconda3), .conda et le fichier .condarc dans C:\Users\VOUS\.
Si vous aviez coché « Add Anaconda to my PATH » à l’installation : tapez « variables d’environnement » dans le menu Démarrer, ouvrez « Modifier les variables d’environnement pour votre compte », puis, dans la variable Path, supprimez les lignes qui contiennent anaconda3 ou miniconda3.

Dans tous les cas

Ouvrez vos fichiers de démarrage (code ~/.zshrc, code ~/.bashrc, ou code $PROFILE sous PowerShell) et vérifiez qu’il ne reste aucun bloc conda initialize. S’il en reste un, supprimez-le en entier, de la ligne >>> à la ligne <<< incluses, puis enregistrez.

Installer uv

uv s’installe en une commande, sans droits administrateur. Sur Mac et Linux :

curl -LsSf https://astral.sh/uv/install.sh | sh

Sous Windows, dans PowerShell :

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Fermez le terminal et rouvrez-en un, puis vérifiez :

uv --version

Vous n’avez pas besoin d’installer Python à part : uv télécharge lui-même la version dont un projet a besoin. Nous verrons ensemble en séance comment créer un projet et y ajouter des bibliothèques (uv init, uv add, uv run).

Vérifier que tout est propre

Ouvrez un nouveau terminal, placez-vous dans un dossier quelconque, puis tapez :

uv --version                         # doit afficher un numéro de version
conda --version                      # « command not found », ou un numéro si vous gardez conda
echo $CONDA_PREFIX                   # doit être vide (sous PowerShell : echo $env:CONDA_PREFIX)
uv run --no-project python -c "import sys; print(sys.executable)"

La dernière ligne affiche le Python que uv utilise : le chemin ne doit contenir ni conda ni anaconda.

Sur Mac, sous Linux ou dans Git Bash, vous pouvez aussi lancer le petit script de diagnostic du cours. Il lit seulement votre configuration et ne modifie rien :

curl -LsSf https://python.mines.prasquier.dev/diagnostic.sh -o diagnostic.sh
bash diagnostic.sh

💡 Si quelque chose résiste, ce n’est pas grave : gardez la sortie du diagnostic (ou une capture de votre terminal) et montrez-la-moi au début de la séance 1, nous réglerons cela ensemble.