fastui_admin

Build better Admin UIs faster.

Build admin interfaces for FastAPI applications using FastUI and SQLAlchemy.

Inspired by Flask-Admin and SQLAdmin.

Note: FastUI Admin is an active work in progress. The API may change as the project matures alongside FastUI.

Table of Contents

• Installation
• Features
• Quick Start
• Configuration
• Examples
• Feature Parity
• Roadmap
• Related
• Support
• Motivation
• About
• Author
• Analysis
• Contributing
• Development
• Releasing
• Credits
• License
• Changelog

Installation

fastui_admin is a library. Add it to your project as a dependency:

uv add fastui-admin

Or with pip:

pip install fastui-admin

For async SQLite support (used in examples):

pip install aiosqlite greenlet

Verify the installation

The package root is importable after installation:

>>> from fastui_admin import __doc__
>>> isinstance(__doc__, str)
True

Features

• Automatic CRUD interface for SQLAlchemy models
• List view with pagination
• Detail, create, edit, and delete views
• Auto-generated forms from model columns
• Navigation bar with registered model views
• Configurable columns, page size, and permissions
• Mounts as a sub-application on FastAPI or Starlette

Quick Start

from fastapi import FastAPI
from sqlalchemy import Boolean, Integer, String
from sqlalchemy.ext.asyncio import create_async_engine
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

from fastui_admin import BaseAdmin, BaseModelView


# Define your models
class Base(DeclarativeBase):
    pass


class User(Base):
    __tablename__ = "users"

    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    username: Mapped[str] = mapped_column(String(50), unique=True)
    email: Mapped[str] = mapped_column(String(100))
    is_active: Mapped[bool] = mapped_column(Boolean, default=True)


# Define admin views
class UserAdmin(BaseModelView, model=User):
    name = "Users"
    column_list = ["id", "username", "email", "is_active"]
    page_size = 25


# Set up the app
app = FastAPI()
engine = create_async_engine("sqlite+aiosqlite:///./db.sqlite3")

admin = BaseAdmin(app, engine, title="My Admin")
admin.add_view(UserAdmin)
admin.mount()

Run the app and visit http://localhost:8000/admin/.

Configuration

BaseAdmin

BaseModelView

Examples

See the examples/simple directory for a complete working example with User and Post models.

# Run the example
uvicorn examples.simple.main:app --port 5000

# Seed sample data
curl -X POST http://localhost:5000/seed

# Visit admin interface
open http://localhost:5000/admin/

Feature Parity

Comparison with Flask-Admin and SQLAdmin (ref: sqladmin#316).

General Features

ModelView Options

Roadmap

See the Roadmap issue for the full feature roadmap, including planned support for column sorting, search/filtering, authentication, export, and more.

Related

• FastUI - Build web UIs with declarative Python
• FastUI Tutorials - Learning resource for FastUI
• SQLAdmin - Admin interface for SQLAlchemy (Jinja2-based)
• Flask-Admin - Admin interface for Flask

Support ❤️

If you have any questions or need help, feel free to open an issue on the GitHub repository.

Motivation

Existing SQLAlchemy admin interfaces render server-side HTML. FastUI Admin brings the same ModelView ergonomics — list, detail, create, edit, and delete views with configurable columns and page size — to FastUI-based FastAPI applications, mounting as a sub-application on FastAPI or Starlette.

About

FastUI Admin provides an automatic CRUD interface for SQLAlchemy models (sync and async), with auto-generated forms from model columns, a navigation bar with registered model views, and configurable columns, page size, and permissions.

Author 🫅

This project is maintained by Hasan Sezer Taşan, It's me 👋

Analysis

• Snyk Python Package Health Analysis
• Libraries.io - PyPI
• Safety DB
• PePy Download Stats
• PyPI Download Stats
• Pip Trends Download Stats
• PyPI Map Dependency Graph

Contributing ❤️

Any contributions are welcome! Please follow the Contributing Guidelines to contribute to this project.

Development 🧰

See the Contributing Guidelines for local setup, the common development tasks (exposed via mise), building and previewing the documentation, and the VS Code debugging configurations.

Releasing

Versioning and releases are automated with release-please, driven by Conventional Commit PR titles squash-merged into main. release-please maintains a release PR that bumps the version and CHANGELOG.md; merging it tags the release and publishes to PyPI. See the Contributing Guidelines for the commit conventions, and the Repository setup guide for one-time configuration and optional post-launch integrations such as a social preview, downstream packaging, and Repology.

Pause merges that change .github/workflows/, including Renovate action-pin updates, from merging a release PR until the entire Release run finishes. Workflow differences between the release commit and current main can block tag or release creation with a 403 when using GITHUB_TOKEN. See Release recovery for prevention and recovery steps.

For adoption or template-update reconciliation, ask your agent to "audit this template adoption/update against our existing project behavior". The shipped template-adoption skill also supports audits after an update was applied. It compares workflow behavior, required checks, custom tooling, and documentation, and asks before consequential cleanup. Its prek-workflow example shows why duplicate commands alone do not justify removing a workflow. Use the sibling repo-setup skill for repository settings and release setup.

Credits

Vibe coded by Claude Opus 4.5, reviewed and tested by @hasansezertasan.

This package was created with Copier and the hasansezertasan/copier-pyproject project template.

License 📜

fastui-admin is distributed under the terms of the MIT license.

Changelog 📝

For a detailed list of changes, please refer to the CHANGELOG.