{"library":"streamlit-echarts","title":"Streamlit ECharts","type":"library","description":"Streamlit ECharts is a Streamlit component that enables the display of highly interactive ECharts visualizations directly within Streamlit applications. The library is actively maintained, with its latest version being 0.6.0, and has a cadence of several major releases per year, often introducing significant updates and breaking changes.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install streamlit-echarts","pip install streamlit-echarts[pyecharts]"],"cli":null},"imports":["from streamlit_echarts import st_echarts","from streamlit_echarts import st_pyecharts","from streamlit_echarts import JsCode"],"auth":{"required":false,"env_vars":[]},"links":{"homepage":null,"github":"https://github.com/andfanilo/streamlit-echarts","docs":null,"changelog":null,"pypi":"https://pypi.org/project/streamlit-echarts/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null},"quickstart":{"code":"import streamlit as st\nfrom streamlit_echarts import st_echarts\nimport json # For PyEcharts conversion\n# import pyecharts.options as opts # Optional: if using pyecharts\n# from pyecharts.charts import Bar # Optional: if using pyecharts\n\nst.set_page_config(layout='wide')\nst.title('Streamlit ECharts Basic Bar Chart')\n\n# ECharts option as a Python dictionary\noptions = {\n    'xAxis': {\n        'type': 'category',\n        'data': ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']\n    },\n    'yAxis': {\n        'type': 'value'\n    },\n    'series': [{\n        'data': [820, 932, 901, 934, 1290, 1330, 1320],\n        'type': 'bar'\n    }]\n}\n\nst.header('Basic ECharts Bar Chart')\nresult = st_echarts(\n    options=options,\n    height='400px',\n    key='basic_bar_chart', # Essential for stable animations/interactions\n    on_select='rerun' # Example: trigger rerun on selection\n)\n\nif result and result.get('selection'):\n    st.write(f\"Selected data point: {result['selection']}\")\n\n# Example with PyEcharts (requires `pip install streamlit-echarts[pyecharts]`)\n# if st.checkbox(\"Show PyEcharts Example (requires pyecharts extra)\"):\n#     b = (\n#         Bar()\n#         .add_xaxis([\"Microsoft\", \"Amazon\", \"IBM\", \"Oracle\", \"Google\"])\n#         .add_yaxis(\"2018 Revenue (billion $)\", [21.2, 20.4, 10.3, 6.08, 4])\n#         .set_global_opts(\n#             title_opts=opts.TitleOpts(title=\"Top Cloud Providers\", subtitle=\"2018 Revenue\")\n#         )\n#     )\n#     st.header('PyEcharts Bar Chart (via st_pyecharts)')\n#     st_pyecharts(b, height=\"400px\", key='pyecharts_chart')\n","lang":"python","description":"This quickstart demonstrates how to render a basic ECharts bar chart using `st_echarts`. It also shows how to use the `key` parameter for stable component identity and `on_select='rerun'` for basic interactivity, capturing selection events in the Streamlit app state. An optional commented section illustrates usage with PyEcharts, which requires an extra installation.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"0.4.0","pypi_latest":"0.6.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":16,"avg_import_s":1.24,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"447.4M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pyecharts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"450.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":16.3,"import_time_s":null,"mem_mb":null,"disk_size":"416M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pyecharts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":16.6,"import_time_s":null,"mem_mb":null,"disk_size":"420M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"468.1M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pyecharts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"471.7M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15,"import_time_s":null,"mem_mb":null,"disk_size":"437M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pyecharts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15.5,"import_time_s":null,"mem_mb":null,"disk_size":"440M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"451.9M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pyecharts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"455.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":14.6,"import_time_s":null,"mem_mb":null,"disk_size":"420M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pyecharts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15.1,"import_time_s":null,"mem_mb":null,"disk_size":"424M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"450.5M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pyecharts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"454.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":14.9,"import_time_s":null,"mem_mb":null,"disk_size":"419M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pyecharts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":15.6,"import_time_s":null,"mem_mb":null,"disk_size":"423M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":1.6,"mem_mb":25.7,"disk_size":"444.6M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pyecharts","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":1.62,"mem_mb":25.7,"disk_size":"444.6M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"streamlit-echarts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":18.3,"import_time_s":0.88,"mem_mb":21,"disk_size":"422M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pyecharts","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":18,"import_time_s":0.85,"mem_mb":21,"disk_size":"422M"}]}}