Aller au contenu
Traduction automatique supervisée

Ce contenu est traduit à l'aide d'une génération automatique guidée par des glossaires et des guides de style élaborés par des humains. Le texte n'étant pas relu manuellement ligne par ligne, des erreurs ou des tournures maladroites peuvent occasionnellement apparaître.

En cas de divergence, la version anglaise constitue la source de référence.

Lire la version originale en anglais

Installation

Installez starlette-admin à l'aide du gestionnaire de paquets de votre choix.

pip install starlette-admin

uv add starlette-admin

starlette-admin nécessite Python 3.11 ou une version ultérieure.

Le paquet principal est indépendant du backend. Pour créer une interface d'administration pour votre application, installez l'intégration appropriée à votre couche de données (telle que SQLAlchemy, Beanie, MongoEngine ou Tortoise ORM) en complément du paquet de base.

Dépendances incluses

L'installation de base inclut tout ce qui est nécessaire au fonctionnement de l'interface d'administration. Aucune dépendance optionnelle n'est installée par défaut.

Dépendance Rôle
Starlette Héberge l'application d'administration.
Jinja2 Fournit le moteur de templates pour les pages de liste, de détail et les formulaires.
python-multipart Analyse les soumissions de formulaires et les téléversements de fichiers.
itsdangerous Signe les cookies pour les jetons CSRF et les messages flash.

Les applications construites avec FastAPI ne nécessitent aucune intégration supplémentaire, car FastAPI repose sur Starlette. Montez simplement l'interface d'administration dans votre application FastAPI existante.

Dépendances optionnelles

starlette-admin fournit les dépendances optionnelles suivantes :

  • pdf : ajoute la prise en charge de l'export PDF (reportlab).
  • i18n : ajoute la prise en charge de l'internationalisation (Babel).
  • tinymce : ajoute la prise en charge des éditeurs de texte enrichi. Installe nh3, qui assainit le HTML soumis par TinyMCEEditorField.
  • s3 : ajoute la prise en charge du stockage objet compatible S3. Installe aiobotocore pour les téléversements asynchrones vers AWS S3 et les services de stockage objet compatibles, tels que MinIO.

Installez une ou plusieurs dépendances optionnelles en même temps que starlette-admin :

# Install the `pdf` extra.
pip install "starlette-admin[pdf]"

# Install multiple extras.
pip install "starlette-admin[i18n,pdf,s3]"

# Install the `pdf` extra.
uv add "starlette-admin[pdf]"

# Install multiple extras.
uv add "starlette-admin[i18n,pdf,s3]"

Installation depuis les sources

Pour utiliser les dernières modifications non encore publiées, installez le paquet directement depuis le dépôt GitHub.

pip install "git+https://github.com/jowilf/starlette-admin.git"

uv add "git+https://github.com/jowilf/starlette-admin.git"

Prochaines étapes

  • Quickstart : créez votre première interface d'administration avec des données réelles.
  • Concepts : découvrez l'architecture fondamentale et les principes de conception derrière starlette-admin.