{"id":13618312,"url":"https://github.com/ObservedObserver/viz-gpt","last_synced_at":"2025-04-14T10:31:28.802Z","repository":{"id":163032046,"uuid":"638240319","full_name":"ObservedObserver/viz-gpt","owner":"ObservedObserver","description":"Make contextual data visualization with Chat Interface from tabular datasets. AI data visualization.","archived":false,"fork":false,"pushed_at":"2024-05-17T08:21:35.000Z","size":207,"stargazers_count":602,"open_issues_count":10,"forks_count":71,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-04T12:32:34.517Z","etag":null,"topics":["ai-data-visualisation","chart","chart-gpt","chartgpt","chat2vis","chatgpt","gpt","text2vis","vega-lite","visualization","visualization-gpt"],"latest_commit_sha":null,"homepage":"https://vizgpt.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ObservedObserver.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":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-09T11:24:42.000Z","updated_at":"2025-04-02T14:10:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b86ca40-bfe3-4aa1-b788-0609fcb3d7a7","html_url":"https://github.com/ObservedObserver/viz-gpt","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObservedObserver%2Fviz-gpt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObservedObserver%2Fviz-gpt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObservedObserver%2Fviz-gpt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ObservedObserver%2Fviz-gpt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ObservedObserver","download_url":"https://codeload.github.com/ObservedObserver/viz-gpt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248862647,"owners_count":21173846,"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":["ai-data-visualisation","chart","chart-gpt","chartgpt","chat2vis","chatgpt","gpt","text2vis","vega-lite","visualization","visualization-gpt"],"created_at":"2024-08-01T20:01:58.373Z","updated_at":"2025-04-14T10:31:28.327Z","avatar_url":"https://github.com/ObservedObserver.png","language":"TypeScript","funding_links":[],"categories":["ChatGPT-based applications","TypeScript"],"sub_categories":["Other sdk/libraries"],"readme":"# VizGPT: AI Data Visualization, Make contextual data visualization with Chat Interface\n\nhttps://github.com/ObservedObserver/viz-gpt/assets/22167673/a09032d3-f3c8-4cdf-ac14-89df8754fd9f\n\n\nUse GPT to generate visualization from datasets with natural language. You can edit the visualization in the context step by step to make it more precise without retyping the complex query. VizGPT turns your text queries and chat into data visualization or charts.\n\nYou can try it at [Playground](https://vizgpt.ai/)\nor vizGPT on Kanaries [kanaries-vizgpt](https://kanaries.net/home/products)\n\n#### Why VizGPT\n\nThere exist lots of great visualization products in the world, such as Tableau, pygwalker. The traditional drag-and-drop visualization tool is hard to use for people unfamiliar with configs and viz/data transformations. For example, making a tableau heatmap requires bin transformations to both axes and then dragging the measure to color. It is hard for people unfamiliar with data visualization to make a heatmap.\n\nSome text2viz tools accept natural language to generate the visualization. However, they are not flexible enough to allow users to edit the visualization. For example, if the user wants to change the color of the heatmap, they have to retype the whole sentence.\n\nWith VizGPT, you can build visualizations step by step with a chat interface. You can edit/adjust visualizations in the context. It allows you to explore the data first without figuring out how to build complex visualization initially, especially when unfamiliar with the data.\n\nBesides, VizGPT focus on text based visual exploration. It allows users to discover new insights from visualization and ask new questions based on the insights they just find.\n\n## Features \u0026 Roadmap\n+ [x] Natural language to data visualization [vega-lite](https://github.com/vega/vega-lite)\n+ [x] Use chat context to edit your visualization. Allow users to change the chart if it is not what they expected\n+ [x] Explore the data step by step by chatting with visualizations.\n+ [x] Upload your own dataset (CSV) to make visulizations.\n+ [ ] Save the visualizations and chat history.\n+ [ ] Allow user to use visualization editor (like [graphic-walker](https://github.com/Kanaries/graphic-walker) or [vega-editor](https://github.com/vega/editor)) to edit the visualization and show the edit to GPT to make better visualization as the user prefers.\n\n\u003e vizGPT is now good at drawing data visualizations, not data transformations/preparation/computation. You can use other tools like Kanaries/RATH to prepare the data first and then use vizGPT to draw the visualization.\n\n## vizGPT + RAG\nI also build a RAG version of vizGPT, which can be accessed at [vizgpt.ai](https://vizgpt.ai), it contains RAG special for vega/vega-lite and SQL. \n\n## Chat to Viz Example\n\u003cimg src=\"https://github.com/ObservedObserver/viz-gpt/assets/22167673/3788bb64-9441-4c1a-b709-307f9bc47e3d\" width=\"68%\" alt=\"vizapt-1\" /\u003e\n\n\u003cimg src=\"https://github.com/ObservedObserver/viz-gpt/assets/22167673/50fc05a3-7511-489d-bb6f-5e0b7568e9cf\" width=\"68%\" alt=\"vizapt-2\" /\u003e\n\n\u003cimg src=\"https://github.com/ObservedObserver/viz-gpt/assets/22167673/5506e5f5-f209-4721-a2ee-61e59180f08f\" width=\"68%\" alt=\"vizapt-3\" /\u003e\n\n![Xnapper-2023-05-10-00 28 07](https://github.com/ObservedObserver/viz-gpt/assets/22167673/9ffb763a-d18d-4867-a974-5ab02131ce1f)\n\n![Xnapper-2023-05-10-01 05 15](https://github.com/ObservedObserver/viz-gpt/assets/22167673/cd2d45c9-f0d4-431c-8ced-5c1228ad24a7)\n\n\n\n### Add custom CSV file\n\nClick `upload CSV button to add your own data. You can view or edit your data's metas at data view. The metas are inferred automatically by default. You can edit it anytime you want to make the visualization more precise.\n\n![data view](https://github.com/ObservedObserver/viz-gpt/assets/22167673/a490e364-bcd1-418f-80eb-62e47faf4330)\n\n\n\n## Local Development\n\n#### step 1\nCreate a `.env` file at the root of the project with the following contents:\n\n```\nBASE_URL=\u003cAzure OpenAI BaseURL\u003e\nDEPLOYMENT_NAME=\u003cDeployment Name\u003e\nAZURE_OPENAI_KEY=\u003cYour key\u003e\n```\n\n#### step 2\n\nInstall dependencies:\n\n```bash\nyarn install\n```\n\n#### step 3\n\nThen run `vercel dev` or `npm run dev` to start the server at port 3000.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FObservedObserver%2Fviz-gpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FObservedObserver%2Fviz-gpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FObservedObserver%2Fviz-gpt/lists"}