starlette-admin

Fast, beautiful, and extensible administrative interface framework for Starlette & FastApi applications

why starlette-admin?

FastAPI has emerged as a popular web framework for building APIs in Python. However, it lacks a mature admin interface solution like Flask-Admin to quickly manage your data through a user-friendly interface. Although solutions like Sqladmin and Fastapi-Admin exist, they only work with specific ORMs such as SQLAlchemy and Tortoise ORM.

Starlette-admin was born from the need for a FastAPI admin interface that works with various data layer. It aims to provide a complete solution for CRUD interfaces regardless of the database backend. Starlette-admin works out of the box with multiple ORM/ODMs and can also be used with a custom data layer.

Getting started

• Check outthe documentation.
• Try thelive demo.(Source code)
• Follow thetutorials
• Try the several usage examples included in the/examplesfolder
• If you find this project helpful or interesting, please consider giving it a star ⭐️

Features

• CRUD any data with ease
• Automatic form validation
• Advanced table widget withDatatables
• Search and filtering
• Search highlighting
• Multi-column ordering
• Export data to CSV/EXCEL/PDF and Browser Print
• Authentication
• Authorization
• Manage Files
• Custom views
• Custom batch actions
• Supported ORMs
  • SQLAlchemy
  • SQLModel
  • MongoEngine
  • ODMantic
  • Custom backend (doc,example)
• Internationalization

Installation

PIP

$ pip install starlette-admin

Poetry

$ poetry add starlette-admin

Example

This is a simple example with SQLAlchemy model

fromsqlalchemyimportcreate_engine
fromsqlalchemy.ext.declarativeimportdeclarative_base
fromsqlalchemy.ormimportMapped,mapped_column
fromstarlette.applicationsimportStarlette

fromstarlette_admin.contrib.sqlaimportAdmin,ModelView

Base=declarative_base()
engine=create_engine("sqlite:///test.db",connect_args={"check_same_thread":False})


# Define your model
classPost(Base):
__tablename__="posts"

id:Mapped[int]=mapped_column(primary_key=True)
title:Mapped[str]


Base.metadata.create_all(engine)

app=Starlette()# FastAPI()

# Create admin
admin=Admin(engine,title="Example: SQLAlchemy")

# Add view
admin.add_view(ModelView(Post))

# Mount admin to your app
admin.mount_to(app)

Access your admin interface in your browser athttp://localhost:8000/admin

Third party

starlette-adminis built with other open source projects:

• Tabler
• Datatables
• jquery
• Select2
• flatpickr
• moment
• jsoneditor
• fontawesome
• TinyMCE

Contributing

Contributions are welcome and greatly appreciated! Before getting started, please read our contribution guidelines