starlette-admin

An extensible administrative interface framework for FastAPI and Starlette applications.

Admin panel

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.

Release files for starlette-admin 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for starlette-admin 1.0.1
File	Size	Uploaded
starlette_admin-1.0.1.tar.gz	1.3 MB	Aug 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for starlette-admin 1.0.1
File	Interpreter	ABI	Platform	Reset
starlette_admin-1.0.1-py3-none-any.whl 1.4 MB Aug 25, 2026	Python 3	none	any	Details

Total release size: 2.6 MB

Release files / starlette_admin-1.0.1.tar.gz

Download URL	starlette_admin-1.0.1.tar.gz
Size	1.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`0a818db92cbf5a2e24b3f1640028d6468d905228b20b8f6621d0ce97841122f8`
BLAKE2b-256 checksum How to use checksums	`ecd5c17af70c83c252195e5daa3e33a6884533c62a1cd4069c511da98c02225f`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.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.1-py3-none-any.whl

Download URL	starlette_admin-1.0.1-py3-none-any.whl
Size	1.4 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`846b97e7a08b6bc453a91ce4ea64d1fe241de3b4555a0207c39c520874dd2ae7`
BLAKE2b-256 checksum How to use checksums	`f5cffec1c43aaaa6e5a328f2f13b5eb049c393ea7c6d6f19c6aa772d2f11b364`
Upload date	Aug 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.5 {"installer":{"name":"uv","version":"0.12.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}`