{"id":26349465,"url":"https://github.com/flask-admin/flask-admin","last_synced_at":"2025-03-16T09:03:15.719Z","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":"2024-10-28T21:17:20.000Z","size":16691,"stargazers_count":5786,"open_issues_count":378,"forks_count":1571,"subscribers_count":154,"default_branch":"master","last_synced_at":"2024-10-29T11:28:18.739Z","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},"funding":{"github":"pallets","custom":"https://palletsprojects.com/donate","tidelift":"pypi/Flask"}},"created_at":"2012-03-18T23:21:57.000Z","updated_at":"2024-10-29T10:26:34.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":29,"template":false,"template_full_name":null,"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","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243719349,"owners_count":20336594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2025-03-16T09:01:53.319Z","updated_at":"2025-03-16T09:03:15.693Z","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://d322cqt584bo4o.cloudfront.net/flask-admin/localized.svg)](https://crowdin.com/project/flask-admin) [![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[discord]: https://discord.gg/pallets\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\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-   and [Peewee](https://github.com/coleifer/peewee).\n\nIt also boasts a simple file management interface and a [Redis\nclient](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\nadd your own, or improve on the existing examples, and submit a\n*pull-request*.\n\nTo run the examples in your local environment:\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/pallets-eco/flask-admin.git\n    cd flask-admin\n    ```\n2. Create and activate a virtual environment:\n\n    ```bash\n    # Windows:\n    python -m venv .venv\n    .venv\\Scripts\\activate\n\n    # Linux:\n    python3 -m venv .venv\n    source .venv/bin/activate\n    ```\n\n3. Navigate into the SQLAlchemy example folder:\n\n    ```bash\n    cd examples/sqla\n    ```\n\n4. Install requirements:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n5. Run the application:\n\n    ```bash\n    python app.py\n    ```\n\n6. Check 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    tox -e docs-html\n\n## Installation\n\nTo install Flask-Admin, simply:\n\n    pip install flask-admin\n\nOr alternatively, you can download the repository and install manually\nby doing:\n\n    git clone https://github.com/pallets-eco/flask-admin.git\n    cd flask-admin\n    pip install .\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\nTo run the tests, from the project directory, simply run:\n\n    pip install --use-pep517 -r requirements/dev.txt\n    pytest\n\nYou should see output similar to:\n\n    .............................................\n    ----------------------------------------------------------------------\n    Ran 102 tests in 13.132s\n\n    OK\n\n**NOTE!** For all the tests to pass successfully, you'll need several services running locally:\nPostgres (with the postgis and hstore extension), MongoDB, and Azurite.\nYou'll also need *libgeos* available.\nSee tests.yaml for Docker configuration and follow service-specific setup below.\n\n## Setting up local Postgres for tests\n\n```bash\npsql postgres\n\u003e CREATE DATABASE flask_admin_test;\n\u003e # Connect to database \"flask_admin_test\":\n\u003e \\c flask_admin_test;\n\u003e CREATE EXTENSION postgis;\n\u003e CREATE EXTENSION hstore;\n```\n\nIf you\\'re using Homebrew on MacOS, you might need this:\n\n```bash\n# Install postgis and geos\nbrew install postgis\nbrew install geos\n\n# Set up a PostgreSQL user\ncreateuser -s postgresql\nbrew services restart postgresql\n```\n\n## Setting up Azure Blob Storage emulator for tests\n\n1. Run the [Azurite emulator](https://learn.microsoft.com/azure/storage/common/storage-use-azurite?tabs=visual-studio%2Cblob-storage)\n\n2. Set the connection string for the emulator:\n\n```bash\nexport AZURE_STORAGE_CONNECTION_STRING=\"DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;\"\n```\n\nYou can also run the tests on multiple environments using *tox*.\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 through Crowdin:\n\u003chttps://crowdin.com/project/flask-admin\u003e\n","funding_links":["https://github.com/sponsors/pallets","https://palletsprojects.com/donate","https://tidelift.com/funding/github/pypi/Flask"],"categories":["Admin Panels","资源列表","Uncategorized","Python","Admin Panels [🔝](#readme)","Awesome Python","Third-Party Extensions","Admin interface","管理面板","Admin UI","Forms, Validation \u0026 Templates","介绍"],"sub_categories":["管理面板","Uncategorized","Admin Panels","Admin","Drone Frames"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflask-admin%2Fflask-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflask-admin%2Fflask-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflask-admin%2Fflask-admin/lists"}