https://github.com/hydrosquall/datasette-nteract-data-explorer
automatic visual data explorer for datasette
https://github.com/hydrosquall/datasette-nteract-data-explorer
automatic-viz datasette datasette-plugin dataviz
Last synced: 5 months ago
JSON representation
automatic visual data explorer for datasette
- Host: GitHub
- URL: https://github.com/hydrosquall/datasette-nteract-data-explorer
- Owner: hydrosquall
- License: apache-2.0
- Created: 2022-03-26T21:47:17.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-04-20T03:33:51.000Z (over 2 years ago)
- Last Synced: 2025-05-07T13:04:30.926Z (5 months ago)
- Topics: automatic-viz, datasette, datasette-plugin, dataviz
- Language: TypeScript
- Homepage: https://datasette-nteract-data-explorer.vercel.app/
- Size: 135 KB
- Stars: 12
- Watchers: 2
- Forks: 1
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# datasette-nteract-data-explorer
[](https://pypi.org/project/datasette-nteract-data-explorer/)
[](https://github.com/hydrosquall/datasette-nteract-data-explorer/releases)
[](https://github.com/hydrosquall/datasette-nteract-data-explorer/actions?query=workflow%3ATest)
[](https://github.com/hydrosquall/datasette-nteract-data-explorer/blob/main/LICENSE)
An automatic data visualization plugin for the [Datasette](https://datasette.io/) ecosystem. See your dataset from multiple views with an easy-to-use, customizable menu-based interface.
## Demo
Try the [live demo](https://datasette-nteract-data-explorer.vercel.app/happy_planet_index/hpi_cleaned?_size=137)
_Running Datasette with the Happy Planet Index dataset_
## Installation
Install this plugin in the same Python environment as Datasette.
```bash
datasette install datasette-nteract-data-explorer
```
## Usage
- Click "View in Data Explorer" to expand the visualization panel
- Click the icons on the right side to change the visualization type.
- Use the menus underneath the graphing area to configure your graph (e.g. change which columns to graph, colors to use, etc)
- Use "advanced settings" mode to override the inferred column types. For example, you may want to treat a number as a "string" to be able to use it as a category.
- See a [live demo](https://data-explorer.nteract.io/) of the original Nteract data-explorer component used in isolation.
You can run a minimal demo after the installation step
```bash
datasette -i demo/happy_planet_index.db
```
If you're interested in improving the demo site, you can run a copy of the site the extra metadata/plugins used in the [published demo](https://datasette-nteract-data-explorer.vercel.app).
```bash
make run-demo
```
Thank you for reading this far! If you use the Data Explorer in your own site and would like others to find it, you can [mention it here](https://github.com/hydrosquall/datasette-nteract-data-explorer/discussions/10).
## Development
See [contributing docs](./docs/CONTRIBUTING.md).
## Acknowledgements
- The [Data Explorer](https://github.com/nteract/data-explorer) was designed by Elijah Meeks. I co-maintain this project as part of the [Nteract](https://nteract.io/) open-source team. You can read about the design behind this tool [here](https://blog.nteract.io/designing-the-nteract-data-explorer-f4476d53f897)
- The data model is based on the [Frictionless Data Spec](https://specs.frictionlessdata.io/).
- This plugin was bootstrapped by Simon Willison's [Datasette plugin template](https://simonwillison.net/2020/Jun/20/cookiecutter-plugins/)
- Demo dataset from the [Happy Planet Index](https://happyplanetindex.org/) was cleaned by Doris Lee. This dataset was chosen because of its global appeal, modest size, and variety in column datatypes (numbers, low cardinality and high cardinality strings, booleans).
- Hosting for the demo site is provided by Vercel.
[](https://vercel.com/?utm_source=datasette-visualization-plugin-demos&utm_campaign=oss)