sitdraw

Installer et utiliser uv : créer un projet Python, ajouter un paquet, lancer un script

Installer uv selon les étapes officielles, initialiser un projet, ajouter un paquet et lancer un script avec uv run.

Pour gérer un projet Python avec uv en local, quatre étapes : installer par le canal officiel, uv init, uv add un paquet, puis uv run un script.

Suivre docs.astral.sh/uv/, ne pas inventer les paquets. Requêtes : installer uv, uv init, lancer un script avec uv run. Installer : astral.sh/uv.

uvNom de commande Astral
initécrit pyproject.toml
runexécute dans l’env projet

Installer le binaire officiel selon l’OS

macOS et Linux

Script officiel : curl -LsSf https://astral.sh/uv/install.sh | sh. Ou brew install uv. Nouveau terminal, uv --version.

Windows

PowerShell : irm https://astral.sh/uv/install.ps1 | iex. Nouvelle session, uv doit être sur le PATH.

ÉtapeCommandeÀ surveiller
Installuv --versionLe shell courant doit voir le binaire officiel
Projetuv init myprojectpyproject.toml doit apparaître
Dépendanceuv add httpxNom PyPI ; le lockfile est mis à jour
Scriptuv run python hello.pyEnv projet ; pas d’activate manuel

Installer, créer, ajouter, exécuter

  1. 01
    Installer et confirmer la version

    docs.astral.sh/uv/getting-started/installation/ pour le script ou Homebrew. uv --version doit afficher une version. Commande absente : nouveau terminal et PATH.

  2. 02
    Créer un projet

    Dans le dossier parent : uv init myproject, puis cd myproject. pyproject.toml doit être là. Dossier vide : uv init seul.

  3. 03
    Ajouter un paquet

    Exemple : uv add httpx. uv résout, écrit le lockfile, prépare l’environnement. En cas d’échec, nom et réseau ; ne pas retoucher un lockfile à moitié écrit.

  4. 04
    Écrire et lancer un script

    Créer hello.py avec le nouveau paquet, puis uv run python hello.py. Pour figer l’interpréteur : d’abord uv python install.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# Après hello.py :
uv run python hello.py
Le script officiel est-il obligatoire ?
Non. La doc cite aussi Homebrew, WinGet, etc. En choisir un, vérifier avec uv --version. Ne pas empiler plusieurs copies qui se disputent le PATH.
Faut-il créer un venv soi-même ?
Pas au quotidien. uv add et uv run utilisent l’environnement du projet. Mettre .venv dans .gitignore, ne pas le committer.
Différence entre uv run et python ?
Un python système peut ignorer les dépendances du projet. uv run choisit l’interpréteur et les paquets du projet.
L’install remplace-t-elle un schéma partagé ?
Non. Toolchain Python. Si la réunion est le même schéma, ouvrir sitdraw.

D’abord uv sur le PATH

Tant que uv --version échoue, ne pas traiter un init raté comme un bug de modèle. Souvent le shell n’a pas chargé le PATH modifié par l’installeur.

Commencer le dessin