Zum Inhalt
Überwachte maschinelle Übersetzung

Dieser Inhalt wurde maschinell übersetzt und basiert auf von Menschen kuratierten Glossaren und Styleguides. Da der Text nicht zeilenweise manuell überprüft wird, können gelegentlich Fehler oder unklare Formulierungen auftreten.

Bei etwaigen Abweichungen ist die ursprüngliche englische Version die maßgebliche Quelle.

Lesen Sie die ursprüngliche englische Version

Installation

Installieren Sie starlette-admin mit dem Paketmanager Ihrer Wahl.

pip install starlette-admin
uv add starlette-admin

starlette-admin erfordert Python 3.11 oder neuer.

Das Kernpaket ist backend-agnostisch. Um eine Admin-Oberfläche für Ihre Anwendung zu erstellen, installieren Sie die passende Integration für Ihre Datenschicht (wie SQLAlchemy, Beanie, MongoEngine oder Tortoise ORM) zusammen mit dem Basispaket.

Enthaltene Abhängigkeiten

Die Basisinstallation umfasst alles, was für den Betrieb der Admin-Oberfläche erforderlich ist. Standardmäßig werden keine optionalen Abhängigkeiten installiert.

Abhängigkeit Zweck
Starlette Hostet die Admin-Anwendung.
Jinja2 Stellt die Template-Engine für Listen-, Detail- und Formularseiten bereit.
python-multipart Verarbeitet Formularübermittlungen und Datei-Uploads.
itsdangerous Signiert Cookies für CSRF-Tokens und Flash-Nachrichten.

Anwendungen, die mit FastAPI erstellt wurden, benötigen keine zusätzliche Integration, da FastAPI auf Starlette aufbaut. Binden Sie die Admin-Oberfläche einfach in Ihre bestehende FastAPI-Anwendung ein.

Optionale Abhängigkeiten

starlette-admin stellt die folgenden optionalen Abhängigkeiten bereit:

  • pdf: Fügt Unterstützung für den PDF-Export hinzu (reportlab).
  • i18n: Fügt Unterstützung für Internationalisierung hinzu (Babel).
  • tinymce: Fügt Unterstützung für Rich-Text-Editoren hinzu. Installiert nh3, das von TinyMCEEditorField übermitteltes HTML bereinigt.
  • s3: Fügt Unterstützung für S3-kompatiblen Objektspeicher hinzu. Installiert aiobotocore für asynchrone Uploads zu AWS S3 und kompatiblen Objektspeicherdiensten wie MinIO.

Installieren Sie eine oder mehrere optionale Abhängigkeiten zusammen mit 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 aus dem Quellcode

Um die neuesten noch unveröffentlichten Änderungen zu verwenden, installieren Sie das Paket direkt aus dem GitHub-Repository.

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

Nächste Schritte

  • Quickstart: Erstellen Sie Ihre erste Admin-Oberfläche mit echten Daten.
  • Konzepte: Lernen Sie die zugrundeliegende Architektur und die Entwurfsprinzipien von starlette-admin kennen.