Python uv — Démarrage rapide : créer votre premier projet

Ce guide emprunte le chemin le plus court pour vous donner un projet Python fonctionnel — votre premier environnement utilisable avec uv. Comme adopter un premier petit loutre : assurez-vous qu'il puisse manger et dormir d'abord ; les techniques avancées de câlin viendront plus tard.

Prérequis

• uv installé (voir la commande d'installation dans la Vue d'ensemble)
• Le terminal peut exécuter la commande uv

Exemple minimal : créer votre premier projet

Étape 1 : Vérifier que uv est installé

uv --version

Si un numéro de version s'affiche, c'est bon. Sinon, relancez le script d'installation et redémarrez le terminal.

Étape 2 : Initialiser le projet

uv init my-app
cd my-app

uv crée automatiquement pyproject.toml, .python-version, main.py et README.md. La structure ressemble à ceci :

my-app/
├── .gitignore
├── .python-version
├── README.md
├── main.py
└── pyproject.toml

Étape 3 : Exécuter le programme par défaut

uv run main.py

Vous verrez Hello from my-app! — félicitations, votre premier projet est vivant.

Étape 4 : Ajouter une dépendance et exécuter

uv add requests

Puis modifiez main.py pour l'essayer :

import requests
r = requests.get("https://httpbin.org/get")
print(r.status_code)

Exécutez :

uv run main.py

Si vous voyez 200, la dépendance a bien été installée dans l'environnement virtuel — pas de pip install manuel, pas de source .venv/bin/activate. Cette sensation de fluidité, c'est le bonheur de uv.

Dépannage courant

Suite

Une fois le projet en marche, il est utile de comprendre ce que font pyproject.toml et uv.lock. L'article suivant couvre ces concepts fondamentaux : 👉 Concepts fondamentaux