Configurer un environnement virtuel

Il est recommandé d’exécuter votre setup Python dans un environnement virtuel. Pour le développement de framework, uv crée et gère l’environnement virtuel à partir du fichier de verrouillage du projet. Les outils tels que pyenv ou Anaconda peuvent toujours fournir l’interpréteur Python, mais ils n’ont pas besoin de créer un environnement de projet séparé.

Version Python

Flower nécessite au moins Python 3.11.

Note

En raison d’une incompatibilité connue avec ray, nous recommandons actuellement d’utiliser au maximum Python 3.11 pour exécuter les simulations Flower.

Virtualenv avec uv

À partir de la racine du dépôt, exécutez le script de bootstrap :

./dev/bootstrap.sh

Cela crée framework/.venv avec la version Python par défaut du dépôt et installe toutes les dépendances de framework à partir de framework/uv.lock. Pour utiliser une version spécifique de Python, passez-la en tant qu’argument sous forme de premier argument :

./dev/bootstrap.sh 3.11.14

Activez l’environnement virtuel créé avec :

source framework/.venv/bin/activate

Vous pouvez également lancer uv directement depuis le répertoire framework:

cd framework
uv sync --python=3.11.14 --locked --all-extras --all-groups

Versions Python avec Pyenv

Si vous utilisez pyenv, installez la version Python que vous voulez uv utiliser :

pyenv install 3.11.14

Puis passez cette version au script de bootstrap :

./dev/bootstrap.sh 3.11.14

Versions Python avec Anaconda

Si vous préférez conda, créez et activez un environnement Python, puis laissez uv créer l’environnement de projet du framework. Voir les conda installation guide pour les instructions d’installation.

conda create -n flower-3.11.14 python=3.11.14
conda activate flower-3.11.14
./dev/bootstrap.sh 3.11.14