# Streamlit-ipyvizzu

**Repository Path**: cool_c0de/Streamlit-ipyvizzu

## Basic Information

- **Project Name**: Streamlit-ipyvizzu
- **Description**: from https://github.com/avrabyt/Streamlit-ipyvizzu 20251017
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-17
- **Last Updated**: 2025-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Streamlit-ipyvizzu (st-vizzu)

**Create animated charts easily! A [ipyvizzu](https://github.com/vizzuhq/ipyvizzu)  wrapper for intuitive usage of ipyvizzu functions and Streamlit embed support.**

[![PyPI version](https://badge.fury.io/py/st-speckmol.svg)](https://pypi.org/project/st-vizzu/)
[![Downloads](https://static.pepy.tech/badge/st-vizzu)](https://pepy.tech/project/st-vizzu)
[![Downloads](https://static.pepy.tech/badge/st-vizzu/month)](https://pepy.tech/project/st-vizzu)
[![Website shields.io](https://img.shields.io/website-up-down-green-red/http/shields.io.svg)](https://hellostvizzu.streamlit.app/)



## Installation 
```console
pip install st-vizzu
```


### ⭐️ Support me to keep this development going ☕️ 
[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/AvraCodes)

## Workflow simplification 

1. **Create** ipyvizzu object using,
`create_vizzu_obj()`
or define preset ipyvizzu charts for example,bar charts using, `bar_chart()`

2. **Animate** the charts using, _generalized_ function, `vizzu_animate()` or _argument specific_ function, `beta_vizzu_animate()`

3. **Embed** the charts within Streamlit front-end using, `vizzu_plot()`

### Quickstart
```python
from st_vizzu import *
import pandas as pd
import streamlit as st

# Load Data
df = pd.read_csv("Data/music_data.csv", index_col=0)
# Create ipyvizzu Object with the DataFrame
obj = create_vizzu_obj(df)

# Preset plot usage. Preset plots works directly with DataFrames.
bar_obj = bar_chart(df,
            x = "Kinds", 
            y = "Popularity",
            title= "1.Using preset plot function `bar_chart()`"
            )

# Animate with defined arguments 
anim_obj = beta_vizzu_animate( bar_obj,
    x = "Genres",
    y =  ["Popularity", "Kinds"],
    title = "Animate with beta_vizzu_animate () function",
    label= "Popularity",
    color="Genres",
    legend="color",
    sort="byValue",
    reverse=True,
    align="center",
    split=False,
)

# Animate with general dict based arguments 
_dict = {"size": {"set": "Popularity"}, 
    "geometry": "circle",
    "coordSystem": "polar",
    "title": "Animate with vizzu_animate () function",
    }
anim_obj2 = vizzu_animate(anim_obj,_dict)

# Visualize within Streamlit
with st.container(): # Maintaining the aspect ratio
    st.button("Animate")
    vizzu_plot(anim_obj2)

```

## Example

[![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://hellostvizzu.streamlitapp.com/)

### Animated charts ✨
![Animation1](https://github.com/avrabyt/Streamlit-ipyvizzu/blob/main/Resources/animation.gif)

### Story-presentation ⌛️
![Story](https://github.com/avrabyt/Streamlit-ipyvizzu/blob/main/Resources/story.gif)

### ipyvizzu-notebook📒 
![notebook](https://github.com/avrabyt/Streamlit-ipyvizzu/blob/main/Resources/notebook.gif)

## Video Tutorials

#### [Part 1](https://youtu.be/jUh923Z4fuk)
[![Convert Excel Sheets to Animated Plots in Python using IPYVIZZU|PART 1](https://github.com/avrabyt/Streamlit-ipyvizzu/blob/3415cb08011e76c78a5f35789659cb5f71014979/Resources/Teaser-2.png)](https://youtu.be/jUh923Z4fuk)

## Resources 
- [streamlit-extras](https://github.com/arnaudmiribel/streamlit-extras) 
- [ipyvizzu](https://github.com/vizzuhq/ipyvizzu)
- [Streamlit-Pages](https://github.com/blackary/st_pages)
- [Streamlit](https://discuss.streamlit.io/)