Saltar a contenido
Traducción automática supervisada

Este contenido se traduce mediante generación automática guiada por glosarios y guías de estilo revisados por personas. Dado que el texto no se revisa manualmente línea por línea, pueden producirse errores ocasionales o expresiones poco naturales.

En caso de cualquier discrepancia, la versión en inglés constituye la autoridad y la fuente de referencia.

Leer la versión original en inglés

Instalación

Instale starlette-admin con el gestor de paquetes de su preferencia.

pip install starlette-admin

uv add starlette-admin

starlette-admin requiere Python 3.11 o posterior.

El paquete principal es agnóstico del backend. Para construir una interfaz de administración para su aplicación, instale la integración adecuada para su capa de datos (como SQLAlchemy, Beanie, MongoEngine o Tortoise ORM) junto con el paquete base.

Dependencias incluidas

La instalación base incluye todo lo necesario para ejecutar la interfaz de administración. No se instala ninguna dependencia opcional de forma predeterminada.

Dependencia Propósito
Starlette Aloja la aplicación de administración.
Jinja2 Proporciona el motor de plantillas para las páginas de lista, detalle y formularios.
python-multipart Procesa los envíos de formularios y la carga de archivos.
itsdangerous Firma las cookies para los tokens CSRF y los mensajes flash.

Las aplicaciones construidas con FastAPI no requieren ninguna integración adicional, ya que FastAPI está construido sobre Starlette. Monte la interfaz de administración en su aplicación FastAPI existente.

Dependencias opcionales

starlette-admin proporciona las siguientes dependencias opcionales:

  • pdf: Añade soporte de exportación a PDF (reportlab).
  • i18n: Añade soporte de internacionalización (Babel).
  • tinymce: Añade soporte de editor de texto enriquecido. Instala nh3, que sanitiza el HTML enviado por TinyMCEEditorField.
  • s3: Añade soporte de almacenamiento de objetos compatible con S3. Instala aiobotocore para cargas asíncronas hacia AWS S3 y servicios de almacenamiento de objetos compatibles, como MinIO.

Instale una o más dependencias opcionales junto con 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]"

Instalación desde el código fuente

Para utilizar los últimos cambios aún no publicados, instale el paquete directamente desde el repositorio de GitHub.

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

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

Próximos pasos

  • Quickstart: Construya su primera interfaz de administración con datos reales.
  • Concepts: Conozca la arquitectura central y los principios de diseño detrás de starlette-admin.