Installer Thonny + Pgzero

Installation rapide

Télécharge le script pour ton système d’exploitation. Un double-clic et il installe Python, uv, Thonny, pgzero, pygame-ce et tout le code de départ pour toi. Prêt en 5 à 10 minutes.

Ton système d'exploitation est en cours de détection...

Afficher tous les téléchargements

Astuce

Le script est sûr : il installe seulement les mêmes programmes que les étapes manuelles ci-dessous. Tu peux consulter le code source en ouvrant le fichier dans le Bloc-notes ou dans un éditeur de texte.

Installation manuelle

Thonny est un éditeur Python gratuit, spécialement conçu pour les débutants. Il installe Python automatiquement. Après l’installation, vérifie quelle version de Python tu as : ton jeu fonctionne avec Python 3.13, 3.14 ou 3.15.

Installer Thonny

Va sur thonny.org et télécharge la version pour ton système d’exploitation.

Windows

Télécharge le fichier .exe et double-clique dessus. Suis les étapes d’installation (clique simplement sur “Next”). Ensuite, tu retrouves Thonny dans le menu Démarrer.

macOS

Télécharge le fichier .pkg et ouvre-le. Glisse Thonny dans ton dossier Applications. La première fois que tu l’ouvres, clique avec le bouton droit et choisis “Open” (pour que macOS lui fasse confiance).

Linux

Ouvre un terminal et tape :

bash <(wget -qO - https://thonny.org/installer-for-linux)

Ou utilise ton gestionnaire de paquets si Thonny y est disponible (par ex. sudo apt install thonny sur Ubuntu).

Remarque

Utilise la version de thonny.org, pas celle de l’app store. Elle est parfois obsolète.

Vérifier la version de Python

Pygame-ce et pgzero ont des versions prêtes à l’emploi pour Python 3.13, 3.14 et 3.15. Les versions plus récentes (3.16 ou plus) ne fonctionnent pas encore.

  1. Ouvre Thonny.
  2. Regarde en bas à droite de la fenêtre. La version active de Python y est affichée, par ex. Python 3.14.8.
  3. Tu vois 3.13, 3.14 ou 3.15 ? Alors tout va bien. Tu vois autre chose ? Installe alors Python 3.14 avec les étapes ci-dessous.
Astuce

Tu vois Python 3.13, 3.14 ou 3.15 ? Saute le reste de cette partie et passe à Installer Pygame-ce.

Installer Python 3.14 et faire pointer Thonny dessus

  1. Va sur python.org/downloads et clique sur “All releases”. Cherche Python 3.14 dans la liste et télécharge l’installeur pour ton système d’exploitation.
    • Windows : choisis le Windows installer (64-bit) et laisse la case “Add Python to PATH” cochée.
    • macOS : choisis le macOS 64-bit universal2 installer.
    • Linux : utilise ton gestionnaire de paquets, par ex. sudo apt install python3.14.
  2. Déroule l’installation et termine-la.
  3. Ouvre Thonny et clique en bas à droite sur le nom de la version de Python (ou va dans Tools → Options → Interpreter).
  4. Choisis “Interpréteur Python 3 alternatif ou environnement virtuel”.
  5. Clique sur l’icône de dossier et navigue jusqu’à l’exécutable Python 3.14 :
    • Windows : C:\Users\<tonnom>\AppData\Local\Programs\Python\Python314\python.exe
    • macOS : /Library/Frameworks/Python.framework/Versions/3.14/bin/python3
    • Linux : /usr/bin/python3.14
  6. Clique sur OK et redémarre Thonny.

En bas à droite, tu vois maintenant Python 3.14. Passe à l’installation de Pygame-ce.

Installer Pygame-ce

Pgzero a besoin de Pygame pour fonctionner. On utilise pygame-ce, la version communautaire maintenue qui fonctionne aussi sur Python 3.14 et 3.15. Dans ton code, ça reste simplement import pygame.

  1. Ouvre Thonny.
  2. Clique en haut sur Tools → Manage packages…
  3. Tape dans le champ de recherche : pygame-ce
  4. Clique sur le résultat de recherche et ensuite sur Install.
  5. Attends la fin de l’installation (tu vois “Done” en bas).

Installer Pgzero

Pgzero est la bibliothèque avec laquelle tu crées des petits jeux. Voici comment l’installer :

  1. Retourne dans Tools → Manage packages…
  2. Tape dans le champ de recherche : pgzero
  3. Clique sur le résultat de recherche et ensuite sur Install.

Vérifie ensuite que la version est 1.2 ou plus. Tu vois la version à droite du nom dans la liste des paquets.

Remarque

L’installation de pgzero bloque sur Python 3.14 ou 3.15 ? C’est parce que pgzero entraîne automatiquement l’ancien pygame, qui n’a pas de version prête à l’emploi pour ces versions. Utilise alors le script d’installation en un clic en haut de cette page, ou choisis Python 3.13 dans Thonny.

Tester si tout fonctionne

Crée un nouveau fichier dans Thonny et colle ce code dedans :

# test_setup.py
import pgzrun

WIDTH = 400
HEIGHT = 300

def draw():
    screen.fill((30, 30, 60))
    screen.draw.text("Pgzero fonctionne !", center=(200, 150), color="white")

pgzrun.go()

Enregistre-le sous test_setup.py et clique sur le bouton vert Run dans Thonny.

Si tout va bien, une fenêtre s’ouvre avec un fond bleu foncé et le texte “Pgzero fonctionne !”. Ferme la fenêtre en cliquant sur la croix.

Ça ne marche pas ?

Pas de panique ! Va voir la page de résolution de problèmes pour les erreurs les plus courantes et comment les résoudre.