Перейти к содержанию
Машинный перевод под контролем человека

Этот контент переведён с помощью машинной генерации, направляемой составленными людьми глоссариями и руководствами по стилю. Поскольку текст не проверяется вручную построчно, возможны отдельные ошибки или неестественные формулировки.

В случае любых расхождений авторитетным источником считается оригинальная версия на английском языке.

Читать оригинал на английском

Установка

Установите starlette-admin с помощью предпочитаемого менеджера пакетов.

pip install starlette-admin

uv add starlette-admin

starlette-admin требует Python 3.11 или новее.

Базовый пакет не зависит от backend-решений. Чтобы создать административный интерфейс для вашего приложения, установите вместе с базовым пакетом подходящую интеграцию для вашего слоя данных (например, SQLAlchemy, Beanie, MongoEngine или Tortoise ORM).

Включённые зависимости

Базовая установка содержит всё необходимое для работы административного интерфейса. По умолчанию необязательные зависимости не устанавливаются.

Зависимость Назначение
Starlette Обеспечивает работу административного приложения.
Jinja2 Предоставляет шаблонизатор для страниц списков, деталей и форм.
python-multipart Разбирает отправленные формы и загружаемые файлы.
itsdangerous Подписывает cookies для CSRF-токенов и flash-сообщений.

Приложениям на FastAPI не требуется дополнительная интеграция, поскольку FastAPI построен на Starlette. Достаточно подключить административный интерфейс к вашему существующему приложению FastAPI.

Необязательные зависимости

starlette-admin предоставляет следующие необязательные зависимости:

  • pdf: добавляет поддержку экспорта в PDF (reportlab).
  • i18n: добавляет поддержку интернационализации (Babel).
  • tinymce: добавляет поддержку rich text editor. Устанавливает nh3, который очищает HTML, отправляемый через TinyMCEEditorField.
  • s3: добавляет поддержку объектных хранилищ, совместимых с S3. Устанавливает aiobotocore для асинхронной загрузки в AWS S3 и совместимые сервисы объектных хранилищ, такие как MinIO.

Установите одну или несколько необязательных зависимостей вместе со 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]"

Установка из исходного кода

Чтобы использовать новейшие ещё не выпущенные изменения, установите пакет напрямую из репозитория GitHub.

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

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

Следующие шаги

  • Быстрый старт: создайте свой первый административный интерфейс с реальными данными.
  • Концепции: ознакомьтесь с основной архитектурой и принципами проектирования starlette-admin.