You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Raoul Snyman a6b4a4c2f5 Change name to quartadmin, and depend on Quart instead of Flask 3 months ago
.github/workflows Update mongo version in CI pipeline 1 year ago
babel update translations 6 years ago
doc Change name to quartadmin, and depend on Quart instead of Flask 3 months ago
examples Change name to quartadmin, and depend on Quart instead of Flask 3 months ago
quartadmin Change name to quartadmin, and depend on Quart instead of Flask 3 months ago
.gitignore Bootstrap 4 form checklists more compact and standard 9 months ago
.gitmodules Removed theme reference. 11 years ago
AUTHORS Updates Managing Files section on the docs and AUTHORS 7 years ago
LICENSE Update LICENSE 3 years ago Fixed #448. Exclude all .pyc files when building pypi package 9 years ago
Makefile Fixed sphinx makefile 11 years ago
NOTICE Correct Bootstrap licensing info 9 years ago
README.rst Add test env setup notes for MacOS 9 months ago
projects.rst Add PMG to project list. 8 years ago
requirements-dev.txt Remove Python 2 residue from requirements-dev.txt 1 year ago
setup.cfg Remove dependency on nose (port to pytest) 2 years ago Change name to quartadmin, and depend on Quart instead of Flask 3 months ago
tox.ini Add `-U` argument to tox.ini to ensure that requirements are updated/re-installed if needed 9 months ago



The project was recently moved into its own organization. Please update your references to




Flask-Admin is a batteries-included, simple-to-use Flask extension that lets you add admin interfaces to Flask applications. It is inspired by the django-admin package, but implemented in such a way that the developer has total control of the look, feel and functionality of the resulting application.

Out-of-the-box, Flask-Admin plays nicely with various ORM's, including

It also boasts a simple file management interface and a redis client console.

The biggest feature of Flask-Admin is flexibility. It aims to provide a set of simple tools that can be used for building admin interfaces of any complexity. So, to start off with you can create a very simple application in no time, with auto-generated CRUD-views for each of your models. But then you can go further and customize those views & forms as the need arises.

Flask-Admin is an active project, well-tested and production ready.


Several usage examples are included in the /examples folder. Please add your own, or improve on the existing examples, and submit a pull-request.

To run the examples in your local environment:

1. Clone the repository::

      git clone
      cd flask-admin

2. Create and activate a virtual environment::

      virtualenv env -p python3
      source env/bin/activate

3. Install requirements::

      pip install -r examples/sqla/requirements.txt

4. Run the application::

      python examples/sqla/


Flask-Admin is extensively documented, you can find all of the documentation at

The docs are auto-generated from the .rst files in the /doc folder. So if you come across any errors, or if you think of anything else that should be included, then please make the changes and submit them as a pull-request.

To build the docs in your local environment, from the project directory:

tox -e docs-html

And if you want to preview any .rst snippets that you may want to contribute, go to


To install Flask-Admin, simply:

pip install flask-admin

Or alternatively, you can download the repository and install manually by doing:

git clone
cd flask-admin
python install


Test are run with pytest. If you are not familiar with this package you can get some more info from their website.

To run the tests, from the project directory, simply:

pip install -r requirements-dev.txt

You should see output similar to:

Ran 102 tests in 13.132s


For all the tests to pass successfully, you'll need Postgres & MongoDB to be running locally. For Postgres:

> psql postgres
CREATE DATABASE flask_admin_test;

> psql flask_admin_test

If you're using Homebrew on MacOS, you might need this:

# install postgis
> brew install postgis

# set up postgresql user
> createuser -s postgresql
> brew services restart postgresql

You can also run the tests on multiple environments using tox.

3rd Party Stuff

Flask-Admin is built with the help of Bootstrap, Select2 and Bootswatch.

If you want to localize your application, install the Flask-BabelEx package.

You can help improve Flask-Admin's translations through Crowdin: