Installation de SageMath sur Windows (à faire 1 seule fois)

Actuellement (2025-09-27), la seule façon d’utiliser SageMath dans Windows est à travers WSL2 (Windows Subsystem for Linux version 2). Plusieurs personnes travaillent à remédier à cela.

En attendant, on peut suivre ces instructions. Elles sont longues, et plusieurs d’entre nous essayons de les rendre plus simples. Pour l’instant, elles ont le mérite d’exister. Elles sont sans doute améliorables, toutes remarques bienvenues.

Attention : Les versions SageMath-9.⋯.exe qu’on peut trouver sur internet ne doivent pas être utilisées. Elles sont trop anciennes et il n’y a aucune garantie qu’elles soient exemptes de contenus malveillants.

Ceci ne peut être fait que sur un compte avec des droits “Administrateur”. Le cas échéant, commencer par changer le type de compte.
Ceci ne peut être fait que sur un seul compte. Si le PC a plusieurs comptes, bien choisir celui qu’on veut utiliser.

Ces instructions ont été testées sur Windows 11 à jour (2025-09-27). Elles devraient aussi fonctionner sur la dernière version de Windows 10, retours bienvenus si ce n’est pas le cas.

Partie 0. Mise à jour de Windows

Il est essentiel de vérifier que Windows est à jour.
Pour les PC sous Windows 10, il convient de les passer sous Windows 11 si c’est possible (fin des mises à jour de W10 le 2025-10-14, avec un possible sursis d’une année dans certains cas).
Attention : Même si Windows Update affirme que le PC est à jour, il convient d’insister, car il est paresseux et il peut y avoir des mises à jour qui tarderont à être affichées.

Partie 1. Installation de WSL2 et Ubuntu

Si WSL2 est déjà installé, le plus simple est de le désinstaller complètement comme indiqué ici (sachant que cela effacera toutes les données Linux).
  1. Chercher Invite de commandes, et Exécuter en tant qu'administrateur.
  2. C:\Windows\System32> wsl --install ⏎ Enter
    Si le téléchargement se bloque, appuyer sur ctrl+C et refaire la commande.
  3. Redémarrer l’ordinateur.
  4. Répéter 1, 2, 3 jusqu’à obtenir Create a default Unix user account: 
  5. Create a default Unix user account: sagelinux ⏎ Enter
New password: [ne s’affiche pas] ⏎ Enter
Retype new password: [ne s’affiche pas] ⏎ Enter
passwd: password updated successfully
$
    On aura besoin de ce mot de passe pour les commandes sudo ci-après.
  6. Fermer la fenêtre.

Partie 2. Mise à jour de Ubuntu

  1. Chercher Ubuntu (ou sinon WSL), l’ouvrir.
  2. $ sudo apt update;sudo apt full-upgrade -y;sudo apt autoremove -y ⏎ Enter

Partie 3. Installation de SageMath

  1. Chercher Ubuntu (ou sinon WSL), l’ouvrir.
  2. $ mkdir -p ~/bin;export PATH="~/bin:$PATH" ⏎ Enter
  3. $ cd ~/bin;curl -fLO https://github.com/3-manifolds/sage_appimage/releases/download/v1.0.0/SageMath-x86_64.AppImage ⏎ Enter
    Si l’on obtient curl: (⋯) The requested URL returned error: 404, cela veut dire que le fichier n’existe pas. Se plaindre (inutile de continuer).
  4. $ chmod +x ~/bin/SageMath-x86_64.AppImage;ln -s SageMath-x86_64.AppImage ~/bin/sage ⏎ Enter
  5. On teste :
    $ sage ⏎ Enter
┌────────────────────────────────────────────────────────────────────┐
│ SageMath version 10.7, Release Date: 2025-08-09                    │
│ Using Python 3.13.3. Type "help()" for help.                       │
└────────────────────────────────────────────────────────────────────┘
sage: factor(2025) ⏎ Enter
3^4 * 5^2
sage: quit ⏎ Enter
$

Partie 4. JupyterLab notebooks

  1. Chercher Ubuntu (ou sinon WSL), l’ouvrir.
  2. $ cd ~/bin;curl -L -O https://moreno.perso.math.cnrs.fr/SageMathWindows/sagemathjupyterlab ⏎ Enter
  3. $ chmod +x ~/bin/sagemathjupyterlab ⏎ Enter
  4. On teste :
    $ sagemathjupyterlab ⏎ Enter
    Si tout va bien, cela ouvrira le navigateur Windows par défaut (Firefox, Google Chrome, Microsoft Edge, Opera, etc.) et l’on pourra gérer des notebooks JupyterLab.
Les fichiers (notebooks avec extension .ipynb, etc.) se trouveront dans Windows dans le dossier Documents\SageMath.

Partie 5. Création d’un raccourci pour un accès direct depuis Windows

  1. Chercher Ubuntu (ou sinon WSL), l’ouvrir.
  2. $ cd `wslpath -au "$(cd /mnt/c;cmd.exe /c 'echo %temp%'|tr -d '\r')"`;curl -L -O https://moreno.perso.math.cnrs.fr/SageMathWindows/SageMath_icon_832x832.ico ⏎ Enter
  3. Fermer la fenêtre Ubuntu pour aller dans Windows.
  4. Chercher Explorateur de fichiers, l’ouvrir.
  5. Aller dans C:\Program Files\WSL
  6. Chercher wsl.exe, faire un clic droit dessus, sélectionner Afficher d’autres d’options > Envoyer vers > Bureau (créer un raccourci)
  7. Fermer Explorateur de fichiers.
  8. Dans le bureau, faire un clic droit sur wsl - Raccourci, sélectionner Propriétés
  9. Dans l’onglet Raccourci, remplir comme suit. 
    Cible : "C:\Program Files\WSL\wsl.exe" -- ~/bin/sagemathjupyterlab 
Démarrer dans : %USERPROFILE%\Documents\SageMath 
Exécuter : Réduite
  10. Cliquer Changer d'icône…
    Cliquer Parcourir…
    Aller dans %temp%
    Sélectionner le fichier SageMath_icon_832x832.ico
    Cliquer Ouvrir
    Cliquer OK
  11. Dans l’onglet Général, remplacer wsl - Raccourci par SageMath JupyterLab
    Cliquer OK
  12. Faire un clic droit sur SageMath JupyterLab et sélectionner Afficher d’autres d’options > Épingler à la barre des tâches
  13. On teste : Si tout va bien, cela ouvrira le navigateur Windows par défaut (Firefox, Google Chrome, Microsoft Edge, Opera, etc.) et l’on pourra gérer des notebooks JupyterLab.

    Avec ces 2 icônes, on n’aura plus besoin d’accéder à Ubuntu.
Les fichiers (notebooks avec extension .ipynb, etc.) se trouveront dans Windows dans le dossier Documents\SageMath.