Why this and not a general plotting library

Lightweight Charts is built for one job: price series that stay smooth while you pan, zoom and stream into them. It handles very large series at 60fps, which general-purpose plotting libraries are not designed for.

This package makes it an ordinary Dash component. You describe the chart with Python dictionaries, and you read and drive it with ordinary Dash callbacks.

Install

pip install dash_tvlwc

Your first chart

import dash
from dash import html
import dash_tvlwc

candles = [
    {'time': '2026-01-01', 'open': 100, 'high': 101.3, 'low': 95.1, 'close': 97.6},
    {'time': '2026-01-02', 'open': 97.6, 'high': 99.1, 'low': 95.2, 'close': 96.1},
    {'time': '2026-01-03', 'open': 96.1, 'high': 98.4, 'low': 90.7, 'close': 92.1},
]

app = dash.Dash(__name__)
app.layout = html.Div([
    dash_tvlwc.Tvlwc(
        series=[{'id': 'price', 'type': 'candlestick', 'data': candles}],
        width='100%',
        height=400,
    ),
])

if __name__ == '__main__':
    app.run()

Each series is one dictionary carrying its own id, type and data. Put several in the list to draw several series on one chart.

What you can do

Each of these is an ordinary prop, set or read from a callback.

What it cannot do

This is a bridge between Python and a JavaScript charting library, and some things do not survive the crossing:

• Anything that has to be a function - custom scaling logic, colour parsers, axis formatters written in Python. Formatters are still possible, but you write them in a small JavaScript file and refer to them by name.
• Plugins, custom series types and drawing tools. These are JavaScript classes in the underlying library, and a class cannot be expressed as a Dash prop.
• Anything that must react within a single frame, such as dragging a trendline. Every interaction routed through a Python callback costs a network round trip.
• Reading a whole dataset back out of the chart. You can ask for one point at a time; you cannot ask for all of them.

The documentation has a page on each of these and what to do instead.

Documentation

• Documentation site - how to express a chart in Python, with worked examples.
• Lightweight Charts v5 API - the full list of chart and series options. Whatever the library accepts, this component passes through.
• demo/app.py - source of the live demo; every panel shows the settings behind it.
• examples/ - runnable apps for styling, callbacks and each capability.

Compatibility

Version 0.2.0 changes the prop schema. Upgrading from 0.1.x is covered by the migration guide.

Contributing

Bug reports and pull requests are welcome. See CONTRIBUTING.md, and DEVELOPMENT.md for building the component from source.

License

MIT. Charts by TradingView, used under the Apache 2.0 license of Lightweight Charts.