echavarria / fastapi-admin

FastAPI Admin Dashboard based on FastAPI and Tortoise ORM.

FastAPI ADMIN

中文文档

Introduction

FastAPI-Admin is a admin dashboard based on fastapi and tortoise-orm.

FastAPI-Admin provide crud feature out-of-the-box with just a few config.

Live Demo

Check a live Demo here https://fastapi-admin.long2ice.cn.

• username: admin
• password: 123456

Data in database will restore every day.

Screenshots

Requirements

• FastAPI framework as your backend framework.
• Tortoise-ORM as your orm framework, by the way, which is best asyncio orm so far and I'm one of the contributors😋.

Quick Start

Run Backend

Look full example at examples.

1. git clone https://github.com/long2ice/fastapi-admin.git.
2. docker-compose up -d --build.
3. docker-compose exec -T mysql mysql -uroot -p123456 < examples/example.sql fastapi-admin.
4. That's just all, api server is listen at http://127.0.0.1:8000 now.

Run Front

See restful-admin for reference.

Backend Integration

> pip3 install fastapi-admin

from fastapi_admin.factory import app as admin_app

fast_app = FastAPI()

register_tortoise(fast_app, config=TORTOISE_ORM, generate_schemas=True)

fast_app.mount('/admin', admin_app)

@fast_app.on_event('startup')
async def startup():
    await admin_app.init(
        admin_secret="test",
        permission=True,
        site=Site(
            name="FastAPI-Admin DEMO",
            login_footer="FASTAPI ADMIN - FastAPI Admin Dashboard",
            login_description="FastAPI Admin Dashboard",
            locale="en-US",
            locale_switcher=True,
            theme_switcher=True,
        ),
    )

Documentation

See documentation at https://long2ice.github.io/fastapi-admin.

Deployment

Deploy fastapi app by gunicorn+uvicorn or reference https://fastapi.tiangolo.com/deployment/.

Restful API Docs

See restful api docs.

Support this project

AliPay	WeChatPay	PayPal
		PayPal to my account long2ice.

License

This project is licensed under the Apache-2.0 License.