{"id":34091756,"url":"https://github.com/djangoaddicts/django-pygwalker","last_synced_at":"2026-04-08T19:33:15.481Z","repository":{"id":184736302,"uuid":"672359330","full_name":"djangoaddicts/django-pygwalker","owner":"djangoaddicts","description":"Easily add PyGWalker visualizations to your Django applications","archived":false,"fork":false,"pushed_at":"2024-09-13T04:11:28.000Z","size":173,"stargazers_count":24,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-12-16T18:21:39.312Z","etag":null,"topics":["data-analysis","django","pygwalker","tableau","tableau-alternative","visualization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/djangoaddicts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-29T20:01:48.000Z","updated_at":"2025-04-25T10:00:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"984fc539-75fd-45f2-8533-a3d4956cf1ee","html_url":"https://github.com/djangoaddicts/django-pygwalker","commit_stats":null,"previous_names":["davidslusser/django-pygwalker"],"tags_count":11,"template":false,"template_full_name":"djangoaddicts/django_package_template","purl":"pkg:github/djangoaddicts/django-pygwalker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djangoaddicts%2Fdjango-pygwalker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djangoaddicts%2Fdjango-pygwalker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djangoaddicts%2Fdjango-pygwalker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djangoaddicts%2Fdjango-pygwalker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djangoaddicts","download_url":"https://codeload.github.com/djangoaddicts/django-pygwalker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djangoaddicts%2Fdjango-pygwalker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31571600,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["data-analysis","django","pygwalker","tableau","tableau-alternative","visualization"],"created_at":"2025-12-14T14:49:44.890Z","updated_at":"2026-04-08T19:33:15.469Z","avatar_url":"https://github.com/djangoaddicts.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# django-pygwalker\n![](https://img.shields.io/pypi/v/django-pygwalker?color=blue) \n[![Downloads](https://static.pepy.tech/badge/django-pygwalker)](https://pepy.tech/project/django-pygwalker)\n![](https://img.shields.io/pypi/status/django-pygwalker)\n\n[![Maintainability](https://api.codeclimate.com/v1/badges/23aa8dc3c2e30ac40cb4/maintainability)](https://codeclimate.com/github/djangoaddicts/django-pygwalker/maintainability)\n[![OpenSSF Best Practices](https://bestpractices.coreinfrastructure.org/projects/7682/badge)](https://bestpractices.coreinfrastructure.org/projects/7682)\n\n![PyPI - Python](https://img.shields.io/pypi/pyversions/django-pygwalker)\n![PyPI - Django](https://img.shields.io/pypi/djversions/django-pygwalker)\n\n\n\nThis utility creates user interfaces for visual analysis using PyGWalker in your django application. A PyGWalker page can be created from a Django queryset, a static csv file, or an uploaded csv file.\n\nFor more information on PyGWalker see the github repo available here: https://github.com/Kanaries/pygwalker \n\n\n\u003cbr/\u003e\n\n## Code Quality\n| Workflow | Description             | Status                                                                       |\n|----------|-------------------------|------------------------------------------------------------------------------|\n|Bandit|security checks|![Bandit](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/bandit.yaml/badge.svg)|\n|Black|code formatting|![Black](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/black.yaml/badge.svg)|\n|CodeQL|security analysis|[![CodeQL](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/github-code-scanning/codeql)|\n|Coveralls|code coverage status|![Coveralls](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/coveralls.yaml/badge.svg)|\n|Isort|python import ordering|![Isort](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/isort.yaml/badge.svg)|\n|Mypy|static type checking|![Mypy](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/mypy.yaml/badge.svg)|\n|Pytest|unit testing|![Pytest](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/pytest.yaml/badge.svg)|\n|Radon|code complexity analysis|![Radon](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/radon.yaml/badge.svg)|\n|Ruff|static code analysis|![Ruff](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/ruff.yaml/badge.svg)|\n|Safety|dependency scanner|![Saftey](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/safety.yaml/badge.svg)|\n|Tox|python/django versions testing|![Tox](https://github.com/djangoaddicts/django-pygwalker/actions/workflows/tox.yaml/badge.svg)|\n\n\n### Code Coverage \n[![Coverage Status](https://coveralls.io/repos/github/djangoaddicts/django-pygwalker/badge.svg)](https://coveralls.io/github/djangoaddicts/django-pygwalker)\n\nDashboard:\nhttps://coveralls.io/github/djangoaddicts/django-pygwalker\n\n\n\u003cbr/\u003e\n\n## Documentation\n[![Documentation Status](https://readthedocs.org/projects/django-pygwalker/badge/?version=latest)](https://django-pygwalker.readthedocs.io/en/latest/?badge=latest)\n\nFull documentation can be found on http://django-pygwalker.readthedocs.org. \n\nDocumentation source files are available in the docs folder.\n\n\n\u003cbr/\u003e\n\n## Installation \n- install via pip:\n    ``` \n    pip install django-pygwalker\n    ```\n- add the following to your INSTALLED_APPS in settings.py:\n\n    ```python \n    djangoaddicts.pygwalker\n    ```\n\n    ***NOTE:*** *adding djangoaddicts.pygwalker to INSTALLED_APPS is only required if you intend to use the built-in templates or the 'generic' PyGWalker view.* \n\n- to include the generic PyGWalker view (creates the PyGWalker page from an upload of a csv file) add the following to your project-level urls.py:\n\n    ```python\n    path(\"pygwalker/\", include(\"djangoaddicts.pygwalker.urls\"), ),\n    ```\n\n\n\u003cbr/\u003e\n\n## Features\n\n### PygWalkerView\nThe PygWalkerView renders a page containing PyGWalker html. This view takes a queryset parameter and includes all data in the queryset for visualizations. By default fields defined in the model will be included. To exclude fields or include additional fields (such as related fields), use the field_list parameter to specify exact fields desired for visualizations.  \n\nA Bootstrap 5 template is included, but can be overwritten using the template_name parameter. \n\n#### Parameters\n- **field_list:** list of model fields to include (defaults to fields defined in the model)\n- **queryset:** queryset providing data available to visualization\n- **theme:** PyGWalker theme to use for pyg html (defaults to \"media\")\n- **title:** title used on html render\n- **template_name:** template used when rendering page; (defaults to pygwalker/bs5/pygwalker.html)\n\n\n\u003cbr/\u003e\n\n## Usage Examples\n\n```python\nfrom djangoaddicts.pygwalker.views import PygWalkerView\n\nclass MyPygWalkerView(PygWalkerView):\n    queryset = MyModel.objects.all()\n```\n\n#### Explicitly Defined Fields\n\n```python\nfrom djangoaddicts.pygwalker.views import PygWalkerView\n\nclass MyPygWalkerView(PygWalkerView):\n    queryset = MyModel.objects.all()\n    title = \"MyModel Data Analysis\"\n    theme = \"light\"\n    field_list = [\"name\", \"some_field\", \"some_other__related_field\", \"id\", \"created_at\", \"updated_at\"]\n```\n\n#### Custom Template\nCustom views/templates can be used to override the Bootstrap 5 templates provided by default view. Here is an example:\n\n```python\nfrom djangoaddicts.pygwalker.views import PygWalkerView\n\nclass MyPygWalkerView(PygWalkerView):\n    queryset = MyModel.objects.all()\n    template_name = \"my_custom_template.html\"\n```\n\n\u003cbr/\u003e\n\n## License\ndjango-pygwalker is licensed under the GNU-3 license (see the LICENSE file for details).\n\nhttps://github.com/djangoaddicts/django-pygwalker/blob/main/LICENSE\n\n\u003cbr/\u003e\n\n## Contributing\nTo contribute to django-pygwalker, please see [Contributing](.github/CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjangoaddicts%2Fdjango-pygwalker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjangoaddicts%2Fdjango-pygwalker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjangoaddicts%2Fdjango-pygwalker/lists"}