starlette-admin
An extensible administrative interface framework for FastAPI and Starlette applications.
Installation
# Using uv
uv add starlette-admin
# Using pip
pip install starlette-admin
Quickstart
Get a fully functional administrative dashboard up and running in minutes. This example demonstrates an integration with FastAPI and SQLAlchemy.
from contextlib import asynccontextmanager
from datetime import datetime, timezone
from fastapi import FastAPI
from sqlalchemy import create_engine
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
from starlette_admin.contrib.sqla import Admin, ModelView
engine = create_engine("sqlite:///blog.db", connect_args={"check_same_thread": False})
class Base(DeclarativeBase):
pass
class Post(Base):
__tablename__ = "posts"
id: Mapped[int] = mapped_column(primary_key=True)
title: Mapped[str]
content: Mapped[str]
published: Mapped[bool] = mapped_column(default=False)
created_at: Mapped[datetime] = mapped_column(
default=lambda: datetime.now(timezone.utc)
)
class PostView(ModelView):
fields = ["id", "title", "content", "published", "created_at"]
searchable_fields = ("title", "content")
@asynccontextmanager
async def lifespan(app: FastAPI):
Base.metadata.create_all(engine)
yield
app = FastAPI(lifespan=lifespan)
admin = Admin(engine, title="Blog Admin", secret_key="change-me")
admin.add_view(PostView(Post, icon="fa fa-newspaper"))
admin.mount_to(app)
Run with fastapi dev and open http://127.0.0.1:8000/admin.
Features
- Generated CRUD pages for your models
- Pagination, sorting, search, and shareable URLs
- Nested AND/OR filter builder
- Inline editing for related models
- Bulk actions and custom row actions
- CSV, Excel, JSON, and PDF export
- CSV, JSON and Excel import with dry-run validation
- Local and S3-compatible file storage (Amazon S3, MinIO, ...)
- Event hooks before and after CRUD operations
- Pluggable authentication, storage, fields, actions, and model views
- Theme customization, dark mode, internationalization, and timezone support
Supported ORMs & Backends
starlette-admin is built to be agnostic. It ships with built-in support for popular ORMs and databases:
| Backend | Package Path |
|---|---|
| SQLAlchemy | starlette_admin.contrib.sqla |
| SQLModel | starlette_admin.contrib.sqlmodel |
| Tortoise ORM | starlette_admin.contrib.tortoise |
| Beanie (MongoDB) | starlette_admin.contrib.beanie |
| MongoEngine | starlette_admin.contrib.mongoengine |
| Custom Data Sources | Subclass BaseModelView |
Documentation & Resources
- Full Documentation
- Quickstart Guide
- User Guide (Covers views, fields, filters, actions, and auth)
- API Reference
Live Demo
Explore the interface in action: starlette-admin-demo.jowilf.com
Contributing
Contributions are always welcome! Whether it is reporting a bug, discussing improvements, or submitting a pull request, your input helps make this project better.
Please review our CONTRIBUTING.md guidelines before opening a pull request.
License
This project is licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for starlette-admin 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| starlette_admin-1.0.3.tar.gz | 1.3 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| starlette_admin-1.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.6 MB
Release files / starlette_admin-1.0.3.tar.gz
| Download URL | starlette_admin-1.0.3.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d215614b85bcccdf57c02b9a3c0c64e21062b8166ec683f2636dfedc6f6ded76
|
|
BLAKE2b-256 checksum How to use checksums |
67a4371bcdf59c3863e0a780a8c619de722ff2830832d9c5a790af36bfb3532c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / starlette_admin-1.0.3-py3-none-any.whl
| Download URL | starlette_admin-1.0.3-py3-none-any.whl |
|---|---|
| Size | 1.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c240c333afed8e6844e3a889dda177818043619d95aeb526052908671aadf7aa
|
|
BLAKE2b-256 checksum How to use checksums |
6e1337097152b35ac8bab1ada12477eb4212d8f707ecd52720b73bc0f40326e0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for starlette-admin 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
