1. Comprendre ce que c’est

Sur la page GitHub, regarder en priorité :

• le fichier README
• le langage utilisé (Python, JavaScript, Swift, Shell, etc.)
• le système d’exploitation cible (Windows, macOS, Linux)

Si ce n’est pas clair immédiatement, ce n’est pas grave. C’est normal quand on débute.

---

2. Télécharger le projet

Option A - Sans terminal (la plus simple)

• Cliquer sur Code
• Cliquer sur Download ZIP
• Dézipper le dossier téléchargé

Option B - Avec terminal

gitclone URL_DU_DEPOT

Dans les deux cas, tu as seulement copié des fichiers.

Rien n’est encore installé.

---

3. Lire le README (obligatoire)

Chercher en priorité les sections suivantes :

• Requirements ou Prerequisites
• Installation
• Usage ou Run

Si le README est vide ou peu clair :

• regarder la section Releases
• regarder les fichiers du projet (.py, .js, .sh, .xcodeproj, etc.)

---

4. Identifier le type de projet

Script simple

Fichiers courants

.sh, .py, .js

Lancement typique :

./script.sh
python script.py
node index.js

---

Application avec binaire prêt à l’emploi

Indices courants

Section Releases

Fichiers .exe, .dmg, .AppImage

Procédure standard sous macOS :

• Ouvrir le dépôt GitHub
• Aller dans Releases
• Télécharger le fichier .dmg ou .zip correspondant à la dernière version
• Ouvrir le fichier téléchargé
• Glisser l’application dans le dossier Applications
• Lancer l’application depuis Applications

Vérifier l’architecture (ARM ou Intel)

Si macOS bloque l’ouverture

Réglages Système → Confidentialité et sécurité → Ouvrir quand même

---

Application à compiler

Indices fréquents :

• .xcodeproj → nécessite Xcode
• package.json → nécessite Node.js
• requirements.txt → nécessite Python
• Makefile → nécessite des outils de compilation

Installer uniquement l’outil correspondant au langage, pas tout le reste.

• Compiler une Application

Quand un projet ne fournit pas de binaire prêt à l’emploi, il faut le compiler ou l’exécuter depuis le code source. La procédure dépend du type de projet.

---

Cas 1. Projet macOS (Swift / SwiftUI)

Indice Présence d’un fichier .xcodeproj ou .xcworkspace Procédure

1. Installer Xcode depuis l’App Store
2. Ouvrir le fichier .xcodeproj avec Xcode
3. Attendre que Xcode configure le projet
4. Sélectionner la cible My Mac
5. Cliquer sur Run (bouton )

L’application se compile et se lance automatiquement.

---

Cas 2. Projet JavaScript / Node.js

Indice Présence d’un fichier package.json Procédure

1. Installer Node.js (depuis nodejs.org)
2. Ouvrir un terminal dans le dossier du projet
3. Installer les dépendances :

 npm install
 
 

1. Lancer le projet :

 npm run start
 
 

ou

 npm run dev
 
 

(selon le README)

---

Cas 3. Projet Python

Indice Présence d’un fichier requirements.txt ou pyproject.toml Procédure

1. Vérifier que Python 3 est installé
2. Ouvrir un terminal dans le dossier du projet
3. Installer les dépendances :

 pip install -r requirements.txt
 
 

1. Lancer le programme :

 python main.py
 
 

(le nom du fichier peut varier)

---

Cas 4. Projet avec Makefile

Indice Présence d’un fichier Makefile Procédure

1. Ouvrir un terminal dans le dossier du projet
2. Lancer :

 make
 
 

1. Si nécessaire, installer les outils demandés par l’erreur affichée
2. Lancer ensuite le programme compilé (nom indiqué par le projet)

---

5. Lancer le projet

Toujours depuis le dossier du projet :

cd nom-du-projet

Puis exécuter la commande indiquée dans le README.

---

6. Si ça ne fonctionne pas

Vérifications essentielles :

• le système d’exploitation est compatible
• le bon langage est installé
• le message d’erreur est lisible et complet
• le README correspond bien à la version utilisée

Copier l’erreur exacte est souvent la clé pour trouver la solution.

---

Règles à retenir

• Cloner un dépôt ne signifie pas installer un logiciel
• GitHub n’est pas un App Store
• Le README fait foi
• L’outil à installer dépend du langage
• Swift implique Xcode
• Un script se lance depuis le terminal
• Compiler signifie transformer le code en programme exécutable

---

Phrase à retenir

Sur GitHub, on lit d’abord.

On installe ensuite.

On exécute en dernier.