How do I add user authentication to fastapi-amis-admin?

Authentication isn't built-in; you need to integrate it separately, such as using the FastAPI-User-Auth library mentioned in the projects list, or implement custom FastAPI middleware for roles and permissions.

Can I use fastapi-amis-admin with NoSQL databases like MongoDB?

It's primarily designed for SQL databases via ORMs like SQLAlchemy. For NoSQL, you'd have to extend the CRUD components significantly, which might require custom code and lack official support.

What's better for a FastAPI project: fastapi-amis-admin or SQLAdmin?

FastAPI-Amis-Admin uses Amis for a low-code frontend and supports multiple ORMs, while SQLAdmin is simpler and closer to raw SQLAlchemy. Choose Amis-Admin for rapid UI generation, but SQLAdmin if you prefer minimal frontend dependencies.

How to customize the admin UI theme and colors?

Use the Amis-Admin-Theme-Editor project from the list for dynamic styling, or override Amis CSS variables. For deep changes, you might need to modify Amis templates or use custom HTML pages as allowed by the extensibility feature.

Is fastapi-amis-admin good for large-scale production apps?

Yes, with FastAPI's performance and async support, it's suitable for production. However, test thoroughly due to its relative newness and watch for breaking changes in updates, as the ecosystem is still evolving.

How do I handle file uploads in the admin interface?

Extend FormAdmin or ModelAdmin to include file fields, leveraging FastAPI's file handling. You'll need to configure storage backends and possibly use custom Amis components, which may require additional setup beyond basic CRUD.

Open-Awesome

FastAPI Amis Admin

Apache-2.0Pythonv0.7.3

A high-performance, efficient, and extensible FastAPI admin framework inspired by Django-admin.

Visit Website GitHub

1.6k stars215 forks0 contributors

What is FastAPI Amis Admin?

FastAPI-Amis-Admin is a high-performance admin framework for FastAPI applications that automatically generates visual dashboards and CRUD interfaces. It solves the need for rapid backend administration panel development by providing Django-admin-like functionality with modern async support.

Target Audience

Python developers building FastAPI-based web applications who need a powerful, extensible admin interface without frontend development overhead.

Value Proposition

Developers choose it for its seamless integration with FastAPI, support for multiple ORMs, automatic API documentation, and the ability to create custom admin pages using Amis or HTML, all while maintaining high performance.

Overview

FastAPI-Amis-Admin is a high-performance, efficient and easily extensible FastAPI admin framework. Inspired by django-admin, and has as many powerful functions as django-admin.

Use Cases

Best For

Rapidly generating admin dashboards for FastAPI projects
Building CRUD interfaces with automatic API documentation
Creating extensible admin panels with custom frontend components
Developing async-ready admin backends with SQLModel or SQLAlchemy
Migrating Django-admin functionality to FastAPI applications
Visual data management interfaces with minimal frontend code

Not Ideal For

Projects requiring deep custom frontend development with frameworks like React or Vue, as Amis provides pre-built, low-code components
Applications not built on FastAPI, since the framework is tightly integrated and doesn't support other web servers
Teams needing real-time, WebSocket-driven admin interfaces, as the focus is primarily on CRUD operations and static dashboards
Environments with strict UI design systems that require pixel-perfect control beyond Amis's templating capabilities

Pros & Cons

Pros

FastAPI Async Performance

Leverages FastAPI's asynchronous capabilities for high-speed request handling, as emphasized in the README's feature list for building efficient admin backends.

Multi-ORM Flexibility

Supports SQLModel, SQLAlchemy, and SQLAlchemy 2.0 with both sync and async modes, allowing developers to use their preferred ORM without lock-in, as detailed in the model creation examples.

Low-Code Frontend with Amis

Uses Amis to auto-generate frontend interfaces, reducing development time for dashboards and CRUD pages without writing HTML/JavaScript, highlighted in the frontend separation feature.

Extensible Admin Pages

Allows custom Amis pages and standard HTML pages, enabling flexible interface design beyond basic admin templates, as shown in the FormAdmin and ModelAdmin examples.

Automatic API Documentation

Integrates with FastAPI to generate interactive API docs, simplifying debugging and sharing of backend interfaces, a key feature mentioned in the README.

Cons

Amis Dependency Lock-in

Reliance on Amis for frontend limits UI customization and may require learning its specific syntax, which can be restrictive for teams needing bespoke designs not covered by Amis components.

Complex ORM Configuration

Supporting multiple ORMs leads to setup overhead, with notes on optional SQLModel installation after version 0.6.0, potentially confusing for beginners or in mixed database environments.

Documentation Reliability Issues

The README includes a link labeled 'can't open the document?', indicating potential accessibility or hosting problems that could hinder learning and troubleshooting.

Limited Ecosystem Maturity

Compared to established alternatives like Django-admin, the ecosystem is smaller with fewer third-party extensions, as evidenced by the separate projects list for add-ons like authentication and scheduling.

Open Source Alternative To

FastAPI Amis Admin is an open-source alternative to the following products:

Django Admin

Django Admin is an automatically generated web-based interface included with Django that allows administrators to manage site content. It provides CRUD operations for models and is highly customizable.

Frequently Asked Questions

Related Projects

FastAPI Admin

A fast admin dashboard based on FastAPI and TortoiseORM with tabler ui, inspired by Django admin

Stars3,810

Forks463

Last commit1 year ago

SQLAlchemy Admin

SQLAlchemy Admin for FastAPI and Starlette

Stars2,802

Forks293

Last commit10 days ago

Starlette Admin

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

Stars1,008

Forks95

Last commit3 days ago

Piccolo Admin

A powerful web admin for your database.

Stars470

Forks48

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub