How to Switch Between Pyecharts V0.5 and V1 – Simple Commands and Tips

Introduction

Pyecharts is a popular Python visualization library built on Echarts, combining Python's data‑processing strengths with interactive charting.

Background

There are two major, incompatible versions of Pyecharts: V0.5 and V1. Code written for one version will fail on the other, as illustrated by the error screenshots.

Switching Methods

From V0.5 to V1

Run the upgrade command: pip install -U pyecharts After upgrading, the library works with the newer API.

From V1 to V0.5

Install the older version and required map packages:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyecharts==0.5.10

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyecharts==0.5.10
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-countries-pypkg
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-china-provinces-pypkg
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-china-cities-pypkg
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-china-counties-pypkg
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-china-misc-pypkg
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple echarts-united-kingdom-pypkg
pip install pyecharts_snapshot

Without the map dependencies, charts render without geographic data; installing them restores proper map display.

Conclusion

The article provides straightforward commands to upgrade to Pyecharts V1 or downgrade to V0.5, noting that V0.5 is no longer maintained and recommending the latest version for new projects.