+0
Daily
15,779
stars
2,833
forks
373
watchers
507
prs
1,957
issues
9
releases
README
pyecharts
Python ❤️ ECharts = pyecharts
English README
📣 简介
Apache ECharts 是一个由百度开源的数据可视化,凭借着良好的交互性,精巧的图表设计,得到了众多开发者的认可。而 Python 是一门富有表达力的语言,很适合用于数据处理。当数据分析遇上数据可视化时,pyecharts 诞生了。
pyecharts like 的可视化项目
py-vchart
py-antv
✨ 特性
简洁的 API 设计,使用如丝滑般流畅,支持链式调用
囊括了 30+ 种常见图表,应有尽有
支持主流 Notebook 环境,Jupyter Notebook、JupyterLab 和 marimo
可轻松集成至 Flask,Sanic,Django 等主流 Web 框架
高度灵活的配置项,可轻松搭配出精美的图表
详细的文档和示例,帮助开发者更快的上手项目
多达 400+ 地图文件,并且支持原生百度地图,为地理数据可视化提供强有力的支持
⏳ 版本
v0.5.x 和 V1 间不兼容,V1 是一个全新的版本,详见 ISSUE892,ISSUE1033。
V0.5.x
支持 Python 2.7,3.4+
经开发团队决定,0.5.x 版本将不再进行维护,0.5.x 版本代码位于 05x 分支,文档位于 05x-docs.pyecharts.org。
V1
仅支持 Python 3.7+
新版本系列将从 v1.0.0 开始,文档位于 pyecharts.org;示例位于 gallery.pyecharts.org
V2
仅支持 Python 3.7+
新版本基于 Echarts 5.4.1+ 进行渲染, 文档和示例位置与 V1 相同
🔰 安装
pip 安装
shell
安装 v1 以上版本
$ pip install pyecharts -U
如果需要安装 0.5.11 版本的开发者,可以使用
pip install pyecharts==0.5.11
源码安装
shell
安装 v1 以上版本
$ git clone https://github.com/pyecharts/pyecharts.git
如果需要安装 0.5.11 版本,请使用 git clone https://github.com/pyecharts/pyecharts.git -b v05x
$ cd pyecharts
$ pip install -r requirements.txt
$ python setup.py install
📝 使用
本地环境
生成 HTML
python
from pyecharts.charts import Bar
from pyecharts import options as opts
V1 版本开始支持链式调用
bar = (
Bar()
.add_xaxis(["衬衫", "毛衣", "领带", "裤子", "风衣", "高跟鞋", "袜子"])
.add_yaxis("商家A", [114, 55, 27, 101, 125, 27, 105])
.add_yaxis("商家B", [57, 134, 137, 129, 145, 60, 49])
.set_global_opts(title_opts=opts.TitleOpts(title="某商场销售情况"))
)
bar.render()
不习惯链式调用的开发者依旧可以单独调用方法
bar = Bar()
bar.add_xaxis(["衬衫", "毛衣", "领带", "裤子", "风衣", "高跟鞋", "袜子"])
bar.add_yaxis("商家A", [114, 55, 27, 101, 125, 27, 105])
bar.add_yaxis("商家B", [57, 134, 137, 129, 145, 60, 49])
bar.set_global_opts(title_opts=opts.TitleOpts(title="某商场销售情况"))
bar.render()
生成图片
python
from snapshot_selenium import snapshot as driver
from pyecharts import options as opts
from pyecharts.charts import Bar
from pyecharts.render import make_snapshot
def bar_chart() - Bar:
c = (
Bar()
.add_xaxis(["衬衫", "毛衣", "领带", "裤子", "风衣", "高跟鞋", "袜子"])
.add_yaxis("商家A", [114, 55, 27, 101, 125, 27, 105])
.add_yaxis("商家B", [57, 134, 137, 129, 145, 60, 49])
.reversal_axis()
.set_series_opts(label_opts=opts.LabelOpts(position="right"))
.set_global_opts(title_opts=opts.TitleOpts(title="Bar-测试渲染图片"))
)
return c
需要安装 snapshot-selenium 或者 snapshot-phantomjs
make_snapshot(driver, bar_chart().render(), "bar.png")
Notebook 环境
Jupyter Notebook
!
JupyterLab
!
Web 框架
!
🔖 Demo
Demo 代码位于 example 文件夹下,欢迎参考 pyecharts 画廊 pyecharts-gallery。
更多详细文档,请访问
中文文档
English Documentation
示例 Example
⛏ 代码质量
单元测试
shell
$ pip install -r test/requirements.txt
$ make
集成测试
使用 Travis CI 和 AppVeyor 持续集成环境。
Top issues
#24803D chart fails in Databricks notebook; explicit ECharts 5.5.1 / ECharts GL 2.0.9 dependencies work0 comments · 2026-09-29#2478dark theme never loads its JS, chart stays default0 comments · 2026-08-16
Discussions
#2430Using pyEcharts with LocalHost-Server in JupyterLab Server2 comments · 2025-02-27#2411ipecharts - Native Jupyter widgets for Echarts0 comments · 2025-01-14#2403how to make these points in Line() disappear?1 comments · 2024-12-06#2402how can I make my chart display in full screen in browser?1 comments · 2024-12-05#2355Plot Custom Polygon Data1 comments · 2024-07-01
Latest release
Version 2.1.0 v2.1.0 2026-02-10Version 2.1.0 - 2026-02-10 (Current) 适配 Echarts 6.X 的第一个版本 Added 新增 Chord 图表类型,包含 ChordData 和 ChordLink 配置项 新增完整的 Matrix 配置项系列 (MatrixOpts、MatrixAxisOpts、MatrixBodyDataOpts、MatrixBodyOrCornerOpts、MatrixBackgroundStyleOpts、MatrixDividerLineStyleOpts) 新增完整的 Thumbnail 配置项系列 (ThumbnailOpts、ThumbnailWindowStyleOpts) 新增 AxisBreak 配置项 (AxisBreakOpts、AxisBreakAreaOpts、AxisBreakLabelLayoutOpts) 新增 CustomItemPayload 配置项系列 (CustomBarRangeItemPayloadOpts、CustomContourItemPayloadOpts、CustomLineRangeItemPayloadOpts、CustomSegmentedDoughnutItemPayloadOpts、CustomStageItemPayloadOpts、CustomVioli