tailtq/notion-table-visualizer

Notion Table Visualizer

Notion Table Visualizer is an open-source project that creates beautiful and informative Pie and Bar charts from your Notion databases, which are not natively supported by Notion. It utilizes Streamlit, Google Cloud Platform (GCP), and other technologies.

Table of Contents

1. Features
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License
6. Acknowledgements

Features

• Retrieve data from Notion tables with ease
• Generate Pie and Bar charts
• Interactive and real-time data visualization
• Customizable chart design
• Responsive design for both desktop and mobile devices
• Secure and private data handling

Getting Started

Prerequisites

Before you start, please ensure you have the following prerequisites installed:

• python>=3.10
• pip

Installation

1. Clone the repository:

git clone https://github.com/tailtq/notion-table-visualizer.git

2. Change directory to the cloned repository:

 notion-table-visualizer

3. Install

   1. Manually:

   pip install -r requirements.txt

   2. Docker:

   docker build --platform=linux/amd64 -t table-visualizer:latest .

Usage

1. Start the Streamlit application:

# for manual installation
streamlit run src/Chart_Configuration.py --browser.serverPort 8080
# for docker installation
docker run -p 8080:8080 table-visualizer:latest

2. Open your web browser and navigate to the URL displayed in the terminal (http://localhost:8080).

3. Follow the instructions on the web page to visualize your Notion table data.

Contributing

We appreciate any contributions, from bug reports to feature requests or improvements. Feel free to open an issue or submit a pull request.

Acknowledgements

• Apache ECharts
• Notion API
• Google Cloud Platform
• Streamlit