Simple and extensible admin interface framework for Flask
Python CSS JavaScript Other
Clone or download
Pull request Compare This branch is 1512 commits behind flask-admin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
babel Updated internal sqla/peewee references Jul 5, 2013
doc Add links to ''. Nov 8, 2013
examples Update Nov 10, 2013
flask_admin Fixed #379. Redirect using request.url when using "save and continue… Nov 19, 2013
.gitignore Formatting changes Nov 14, 2013
.gitmodules Removed theme reference. Mar 21, 2012
.travis.yml Rename requirements.txt to travis.txt Aug 29, 2013
AUTHORS Fixed #178 Jul 20, 2013
LICENSE Separated sqla model conversion from wtforms Aug 25, 2012 Added the tests directory to Mar 19, 2013
Makefile Fixed sphinx makefile Oct 24, 2012
README.rst Minor formatting fixes. Nov 8, 2013
TODO.txt Fixed #247. on_model_change now accepts third parameter is_created Jul 20, 2013
projects.rst Typo Jul 20, 2013
setup.cfg Run all the tests Oct 8, 2012 Python 2 fixes Jun 13, 2013
travis.txt Rename requirements.txt to travis.txt Aug 29, 2013




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 feel free to add your own examples, or improve on some of the existing ones, and then submit them via GitHub as a pull-request.

You can see some of these examples in action at

To run one of the examples in your local environment, simply:

cd flask-admin
python examples/simple/


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:

sudo pip install sphinx
cd flask-admin
sudo make html

Or, 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 nose. If you are not familiar with this package you can get some more info from their website.

To run the tests, simply:

pip install nose

and then:

cd flask-admin

You should see output similar to:

Ran 41 tests in 2.092s

Please note that you will need to install some additional dependencies in order for all of the tests to be executed successfully.

3rd Party Stuff

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

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