{"id":11630908,"url":"https://github.com/pallets-eco/flask-admin","last_synced_at":"2026-01-15T22:21:08.817Z","repository":{"id":2760824,"uuid":"3758878","full_name":"pallets-eco/flask-admin","owner":"pallets-eco","description":"Simple and extensible administrative interface framework for Flask","archived":false,"fork":false,"pushed_at":"2026-01-12T19:36:57.000Z","size":18864,"stargazers_count":6050,"open_issues_count":153,"forks_count":1631,"subscribers_count":151,"default_branch":"master","last_synced_at":"2026-01-13T04:06:21.065Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://flask-admin.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pallets-eco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"pallets","custom":"https://palletsprojects.com/donate","tidelift":"pypi/Flask"}},"created_at":"2012-03-18T23:21:57.000Z","updated_at":"2026-01-12T19:37:03.000Z","dependencies_parsed_at":"2024-04-28T01:51:03.642Z","dependency_job_id":"47ba02a1-63fe-484b-a208-5df03fcf9e98","html_url":"https://github.com/pallets-eco/flask-admin","commit_stats":{"total_commits":2303,"total_committers":380,"mean_commits":6.060526315789474,"dds":0.822405557967868,"last_synced_commit":"9552b2710880036de9a488261b2299ec2ebc57b5"},"previous_names":["pallets-eco/flask-admin","flask-admin/flask-admin"],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/pallets-eco/flask-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pallets-eco%2Fflask-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pallets-eco%2Fflask-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pallets-eco%2Fflask-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pallets-eco%2Fflask-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pallets-eco","download_url":"https://codeload.github.com/pallets-eco/flask-admin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pallets-eco%2Fflask-admin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28472626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T22:13:38.078Z","status":"ssl_error","status_checked_at":"2026-01-15T22:12:11.737Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-06-24T04:05:27.564Z","updated_at":"2026-01-15T22:21:08.806Z","avatar_url":"https://github.com/pallets-eco.png","language":"Python","readme":"# Flask-Admin\n\nFlask-Admin is now part of Pallets-Eco, an open source organization managed by the\nPallets team to facilitate community maintenance of Flask extensions. Please update\nyour references to `https://github.com/pallets-eco/flask-admin.git`.\n\n[![image](https://github.com/pallets-eco/flask-admin/actions/workflows/tests.yaml/badge.svg?branch=master)](https://github.com/pallets-eco/flask-admin/actions/workflows/test.yaml)\n\n## Pallets Community Ecosystem\n\n\u003e [!IMPORTANT]\\\n\u003e This project is part of the Pallets Community Ecosystem. Pallets is the open\n\u003e source organization that maintains Flask; Pallets-Eco enables community\n\u003e maintenance of related projects. If you are interested in helping maintain\n\u003e this project, please reach out on [the Pallets Discord server][discord].\n\n## Introduction\n\nFlask-Admin is a batteries-included, simple-to-use\n[Flask](https://flask.palletsprojects.com/) extension that lets you add admin\ninterfaces to Flask applications. It is inspired by the *django-admin*\npackage, but implemented in such a way that the developer has total\ncontrol over the look, feel, functionality and user experience of the resulting\napplication.\n\n\u003cimg alt=\"image\" src=\"https://github.com/user-attachments/assets/177c1ffd-1f55-4c0d-88a8-abce0d3371f6\" /\u003e\n\n\nOut-of-the-box, Flask-Admin plays nicely with various ORM\\'s, including\n\n- [SQLAlchemy](https://www.sqlalchemy.org/)\n- [pymongo](https://pymongo.readthedocs.io/)\n- [MongoEngine](https://mongoengine.org/)\n- and [Peewee](https://github.com/coleifer/peewee).\n\nIt also boasts a simple file management interface and a [Redis client](https://redis.io/) console.\n\nThe biggest feature of Flask-Admin is its flexibility. It aims to provide a\nset of simple tools that can be used to build admin interfaces of\nany complexity. To start off, you can create a very simple\napplication in no time, with auto-generated CRUD-views for each of your\nmodels. Then you can further customize those views and forms as\nthe need arises.\n\nFlask-Admin is an active project, well-tested and production-ready.\n\n## Examples\n\nSeveral usage examples are included in the */examples* folder. Please add your own, or improve on the existing examples, and submit a *pull-request*.\n\n### How to run an example\n\nClone the repository and navigate to an example (for this example we are using SQLAlchemy Example):\n\n```shell\ngit clone https://github.com/pallets-eco/flask-admin.git\ncd flask-admin/examples/sqla\n```\n\n\u003e All examples use [`uv`](https://docs.astral.sh/uv/) to manage their dependencies and the developer environment.\n\nRun the example using `uv`, which will manage the environment and dependencies automatically:\n\n```shell\nuv run main.py\n```\n\nCheck the Flask app running on \u003chttp://localhost:5000\u003e.\n\n## Documentation\n\nFlask-Admin is extensively documented, you can find all of the\ndocumentation at \u003chttps://flask-admin.readthedocs.io/en/latest/\u003e.\n\nThe docs are auto-generated from the *.rst* files in the */doc* folder.\nIf you come across any errors or if you think of anything else that\nshould be included, feel free to make the changes and submit a *pull-request*.\n\nTo build the docs in your local environment, from the project directory:\n\n```shell\ntox -e docs\n```\n\n## Installation\n\nTo install Flask-Admin using pip, simply:\n\n```shell\npip install flask-admin\n```\n\n## Contributing\n\nIf you are a developer working on and maintaining Flask-Admin, checkout the repo by doing:\n\n```shell\ngit clone https://github.com/pallets-eco/flask-admin.git\ncd flask-admin\n```\n\nFlask-Admin uses [`uv`](https://docs.astral.sh/uv/) to manage its dependencies and developer environment. With\nthe repository checked out, to install the minimum version of Python that Flask-Admin supports, create your\nvirtual environment, and install the required dependencies, run:\n\n```shell\nuv sync\n```\n\nThis will install Flask-Admin but without any of the optional extra dependencies, such as those for sqlalchemy\nor mongoengine support. To install all extras, run:\n\n```shell\nuv sync --extra all\n```\n\nFinally, enable pre-commit hooks:\n\n```shell\npre-commit install\n```\n\n## Tests\n\nTests are run with *pytest*. If you are not familiar with this package, you can find out more on [their website](https://pytest.org/).\n\n### Running tests inside the devcontainer (eg when using VS Code)\n\nIf you are developing with the devcontainer configuration, then you can run tests directly using either of the following commands.\n\nTo just run the test suite with the default python installation, use:\n\n```shell\nuv run pytest\n```\n\nTo run the test suite against all supported python versions, and also run other checks performed by CI, use:\n\n```shell\nuv run tox\n```\n\n### Running tests as a one-off via docker-compose run / `make test`\n\nIf you don't use devcontainers then you can run the tests using docker (you will need to install and setup docker yourself). Then you can use:\n\n```shell\nmake test-in-docker\n```\n\nThis will use the devcontainer docker-compose configuration to start up postgres, azurite and mongo.\n\nYou can also run the full test suite including CI checks with:\n\n```shell\nmake tox-in-docker\n```\n\n## 3rd Party Stuff\n\nFlask-Admin is built with the help of\n[Bootstrap](https://getbootstrap.com/),\n[Select2](https://github.com/ivaynberg/select2) and\n[Bootswatch](https://bootswatch.com/).\n\nIf you want to localize your application, install the\n[Flask-Babel](https://pypi.python.org/pypi/Flask-Babel) package.\n\nYou can help improve Flask-Admin\\'s translations by opening a PR.\n## As a developer who's changed some text in Flask-Admin\n```bash\nuv sync --group docs\ncd babel\n./babel.sh --update\n```\n\n## As a translator who's updated some `.po`/`.mo` files\nRun `cd babel`\nRun `./babel.sh`\n\n\u003c!-- refs --\u003e\n[discord]: https://discord.gg/pallets\n","funding_links":["https://github.com/sponsors/pallets","https://palletsprojects.com/donate","https://tidelift.com/funding/github/pypi/Flask"],"categories":["Python","HarmonyOS","Third-Party Extensions","Admin UI","Miscellaneous","Admin Panels"],"sub_categories":["Windows Manager","Admin"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpallets-eco%2Fflask-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpallets-eco%2Fflask-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpallets-eco%2Fflask-admin/lists"}