Open Source · MIT Licensed

echartsy

A matplotlib-style Python API for Apache ECharts. Write familiar code, get beautiful interactive charts. pandas-native, 16 chart types, built for notebooks and dashboards.

$ pip install echartsy
Copy
View on GitHub → PyPI ↗
echartsy output — Jupyter Notebook
16
Chart types
5,393
Lines of code
15
Python files
v0.5.2
Latest release
MIT
License
How it works
Five lines from data
to interactive chart

If you know matplotlib, you already know echartsy. Same fluent API, but the output is an interactive ECharts visualisation you can hover, zoom, and embed.

dashboard.py Python 
from echartsy import Figure
from echartsy.styles import StylePreset
import pandas as pd

# Load your data
df = pd.DataFrame({
    "month": ["Jan","Feb","Mar","Apr","May","Jun"],
    "revenue": [2.1,2.4,2.8,3.1,2.9,3.3]
})

# Create the chart
fig = Figure(style=StylePreset.DASHBOARD_DARK)
fig.bar(df, x="month", y="revenue")
fig.show()
Output Interactive
analytics.py Python 
from echartsy import Figure

fig = Figure(title="Quarterly Growth")
fig.plot(
    df,
    x="quarter",
    y="users",
    smooth=True,
    area=True
)
fig.show()
Output Interactive
Features
Built for people who
already know Python
df
pandas-native
Pass DataFrames directly. No manual data wrangling. Column names become axis labels automatically.
16
16 chart types
Bar, line, scatter, pie, donut, area, heatmap, radar, boxplot, candlestick, funnel, gauge, treemap, sunburst, sankey, and parallel.
⟳
Multi-renderer
Works in Jupyter notebooks, Streamlit apps, and plain browser output. One API, every environment.
▸
Timeline animations
Animate data over time with built-in timeline support. Show how metrics evolve without writing any JS.
◈
4 style presets
CLINICAL, DASHBOARD_DARK, KPI_REPORT, MINIMAL — production-ready themes you can apply in one line.
✓
Eager validation
Catches bad column names, wrong data types, and invalid configs before rendering. Clear error messages, not silent failures.
Chart types
Sixteen ways to
see your data
▊
Bar
╱
Line
·
Scatter
◕
Pie
◔
Donut
▓
Area
▦
Heatmap
⬡
Radar
⊞
Boxplot
⫿
Candlestick
▽
Funnel
◎
Gauge
▤
Treemap
◉
Sunburst
⇶
Sankey
≡
Parallel
Style presets
Production themes
in one line
Clinical
Clean whites, medical blues
Dashboard Dark
Dark theme, warm accents
KPI Report
Boardroom-ready, minimal
Minimal
Stripped back, data-forward

Start charting in
five minutes

Install echartsy, pass a DataFrame, call .show(). That's it. The rest is just making it look exactly how you want.

GitHub → PyPI ↗ Questions? Email us