Promptchart

PromptChart is an open-source, framework-agnostic system that converts natural language prompts into safe, on-demand data visualizations.

How It Works

1. prompt-chart component sends a natural language prompt (e.g., "Show sales by region")
2. Backend sends the prompt to an LLM to generate structured intent
3. A data adapter executes the query against your data source
4. Chart-ready data is returned and rendered

:beginner: Getting started

:desktop_computer: UI

npm install prompt-chart

If using React, install the following instead:

npm install prompt-chart-react

Simply add the following to your markup:

<prompt-chart></prompt-chart>

The exact syntax for the above will vary depending on the framework of your choice. Check out live codepen examples for your UI framework/library of choice:

React	Vue 2	Vue 3	Svelte	SvelteKit	Angular	Solid	Next	Nuxt	VanillaJS

:gear: Backend

This repository has multiple examples for various backend frameworks. See the examples directory. All of the examples have been configured to automatically work with the ui project:

Express	Nest	Flask	FastAPI	Spring	Go	SvelteKit	Next	.NET

:robot: Install with AI

Use the llms.txt file as a reference for installing and configuring PromptChart with your code assistant:

"Use https://github.com/OvidijusParsiunas/PromptChart/blob/main/llms.txt to add a chat component to my website."

:globe_with_meridians: Documentation

Make sure to checkout the official website for more information!

:heart: Contributions

Open source is built by the community for the community. All contributions to this project are welcome!
Additionally, if you have any suggestions for enhancements, ideas on how to take the project further or have discovered a bug, do not hesitate to create a new issue ticket and we will look into it as soon as possible!