pyecharts /pyecharts

🎨 Python Echarts Plotting Library

★ 15,779⑂ 2,833👁 373⑃ 507● 1,957▤ 9
PythonMITCreated 2017-06-22pyecharts.org
Download: Version 2.1.0Version-2.1.0 ↓2.1.02026-02-10
+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

Discussions

Latest release

Version 2.1.0 v2.1.0 2026-02-10
Version 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON