Skip to content

thesysdev/streamlit-thesys-genui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

streamlit-thesys

Generative Visualizations in Streamlit, powered by C1 by Thesys.


What is streamlit-thesys?

streamlit-thesys is a Streamlit package that lets you generate charts and visualizations using C1 by Thesys.

Instead of manually coding every st.pyplot or st.plotly_chart, you can describe the chart you want in plain language and Thesys will create it in real time.

If you’ve ever asked:

  • “How do I generate charts from my data in Streamlit using AI?”
  • “Can I create plots without writing matplotlib or plotly code?”
  • “What’s the fastest way to connect Thesys with Streamlit for Generative Visualizations?”

👉 This package is your answer.


⚡ Features

  • AI-generated charts — bar, line, scatter, histogram, pie, and more.
  • Query-to-Chart — describe your data question in text, get a chart back.
  • Seamless integration with C1 by Thesys.
  • Works with your data — Pandas DataFrames, CSVs, or APIs.
  • Exploratory analysis — iterate on visualizations in seconds.

📦 Installation

pip install streamlit-thesys

🏁 Quickstart

import streamlit as st
import pandas as pd
import streamlit_thesys as thesys

# Load some example data
df = pd.read_csv("sales.csv")
# Thesys API key can be generated at https://console.thesys.dev/
api_key = "<insert your api key here>"

st.title("Generative Visualizations with Thesys")

# Generate a chart dynamically
thesys.visualize(
  instructions="Show monthly sales as a line chart",
  data=df,
  api_key=api_key
)

# Try another
thesys.visualize(
  instructions="Plot top 5 products by revenue as a bar chart",
  data=df,
  api_key=api_key)

🎯 Why Use Thesys for Visualizations in Streamlit?

  • Speed: No need to hand-code chart logic.
  • Flexibility: Quickly try different chart types with natural language prompts.
  • Accessibility: Anyone can generate charts — no matplotlib or plotly knowledge required.
  • Exploration: Move faster when analyzing and presenting your data.

❓FAQ

Q: Which visualization libraries does this use? This used the Thesys C1 component under the hood which is based on other JS visualization libraries.

Q: Can I use my own dataset? Yes — pass a Pandas DataFrame, CSV, or API response directly.

Q: How is this different from coding charts in Streamlit manually? You don’t have to specify every chart property. Thesys interprets natural language and builds the chart for you.

Q: Does it work with time series / categorical / numeric data? Yes. Thesys adapts the visualization type to the data you provide.


📚 Resources


🚀 Next Steps

  • Explore the examples folder.

  • Try prompts like:

    • “Compare revenue by region in a bar chart.”
    • “Plot customer growth over time as a line chart.”
    • “Show distribution of order sizes with a histogram.”
  • Share your results with the Thesys community.

About

Generative UI for Streamlit powered by C1 by Thesys

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors