<p align="center"> <a href="https://github.com/aminalaee/sqladmin"> <img width="400px" src="https://yellow-cdn.veclightyear.com/835a84d5/4c9736c6-f5cd-4c5d-852f-b4028fc19261.png" alt"SQLAdmin"> </a> </p> <p align="center"> <a href="https://github.com/aminalaee/sqladmin/actions"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/f07d8320-f4cf-43da-aa27-229e8dca56f2.svg" alt="构建状态"> </a> <a href="https://github.com/aminalaee/sqladmin/actions"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/8fda93e4-ed0b-4f76-96b4-50d7bd41c09e.svg" alt="发布状态"> </a> <a href="https://codecov.io/gh/aminalaee/sqladmin"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/8d20c3a4-1a55-44c4-a75f-4f89f00cc69b.svg" alt="覆盖率"> </a> <a href="https://pypi.org/project/sqladmin/"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/f07569cb-9a5a-4c5e-be13-56f057b51450.svg" alt="包版本"> </a> <a href="https://pypi.org/project/sqladmin" target="_blank"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/55e28353-bff2-4621-9e14-8d66ed7876cf.svg?color=%2334D058" alt="支持的Python版本"> </a> </p>

---

用于Starlette/FastAPI的SQLAlchemy管理界面

SQLAdmin是一个灵活的SQLAlchemy模型管理界面。

主要特性包括：

• 支持SQLAlchemy同步/异步引擎
• 集成Starlette
• 集成FastAPI
• 使用WTForms构建表单
• 支持SQLModel
• 使用Tabler的用户界面

---

文档：https://aminalaee.dev/sqladmin

源代码：https://github.com/aminalaee/sqladmin

在线演示：演示

---

安装

使用pip安装：

$ pip install sqladmin

这将安装带有可选依赖的完整版sqladmin：

$ pip install "sqladmin[full]"

---

截图

<img width="1492" alt="sqladmin-1" src="https://yellow-cdn.veclightyear.com/835a84d5/348bbe3e-1df7-42e5-9117-a37e568aecf4.png"> <img width="1492" alt="sqladmin-2" src="https://yellow-cdn.veclightyear.com/835a84d5/174d042f-c4e0-49b9-b27f-4ebc1e415b68.png">

快速开始

让我们定义一个示例SQLAlchemy模型：

from sqlalchemy import Column, Integer, String, create_engine
from sqlalchemy.orm import declarative_base


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


class User(Base):
    __tablename__ = "users"

    id = Column(Integer, primary_key=True)
    name = Column(String)


Base.metadata.create_all(engine)  # 创建表

如果你想在FastAPI中使用SQLAdmin：

from fastapi import FastAPI
from sqladmin import Admin, ModelView


app = FastAPI()
admin = Admin(app, engine)


class UserAdmin(ModelView, model=User):
    column_list = [User.id, User.name]


admin.add_view(UserAdmin)

或者如果你想在Starlette中使用SQLAdmin：

from sqladmin import Admin, ModelView
from starlette.applications import Starlette


app = Starlette()
admin = Admin(app, engine)


class UserAdmin(ModelView, model=User):
    column_list = [User.id, User.name]


admin.add_view(UserAdmin)

现在在浏览器中访问/admin，你就可以看到SQLAdmin界面了。

相关项目和灵感来源

• Flask-Admin Flask的管理界面，支持不同的数据库后端和ORM。这个项目极大地启发了SQLAdmin，大多数功能和配置的实现方式都是相同的。
• FastAPI-Admin FastAPI的管理界面，与TortoiseORM配合使用。
• Dashboard ASGI框架的管理界面，与orm包配合使用。