chart-engine 0.9.1

High-performance charting engine built with Rust and Tauri

🚀 LWC Chart Engine

A high-performance charting engine built with Rust, Tauri, and Lightweight Charts. This library provides a seamless, non-blocking Python API for streaming and visualizing large datasets via Polars.

installable wheels for Os are in wheels/ folder

💎 Features

• High Performance: Native Rust backend for low-latency data streaming.
• Embedded UI: Minified frontend assets bundled directly into the distribution.
• Python Integration: First-class support for Polars DataFrames.

🚀 Quick Start

We provide scripts to automate the build and installation process. Choose the one that fits your needs:

🛠 Development Build

For a fast development cycle (installs in your current environment):

./helpers/dev.sh

📦 Production Build

To generate a distribution-ready wheel:

./helpers/create-wheels.sh

📊 Examples

Dive into the examples/ directory to see the full capabilities:

• static_charts.py: Basic rendering of historical OHLC data.
• live_chart_emulation.py: Real-time data streaming and auto-scrolling.
• drawing_tools.py: Programmatic Trendlines, Rays, Fibonacci, and Boxes.
• multi_chart_layouts.py: Building complex workspaces with 2, 3, or 4 subcharts.
• paper_trading.py: Backend programmatic execution and TP/SL visual management.
• ui_customization.py: Full control over tooltips, watermarks, timezones, and legends.

📚 Documentation

For a full list of methods, configuration options, and advanced drawing logic, see the API Documentation.

🏗 Prerequisites

To build the package from source, ensure you have the following toolchains and dependencies installed.

⚙ Toolchains

• Rust: Latest stable (cargo, rustc).
• Python: 3.12+ (or 3.13 for the provided wheel).
• Node.js: Needed for frontend asset minification (esbuild).
• Maturin: pip install maturin (for building the Python extension).

🐧 Linux Dependencies

🛠 For Building from Source

Ubuntu / Debian:

sudo apt update && sudo apt install -y libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev

Arch Linux:

sudo pacman -S gtk3 webkit2gtk-4.1 libayatana-appindicator librsvg

📦 For Running Pre-built Wheels

If you installed the pre-built wheel (from PyPI or GitHub), you only need the runtime libraries:

Ubuntu / Debian:

sudo apt update && sudo apt install -y libgtk-3-0 libwebkit2gtk-4.1-0 libjavascriptcoregtk-4.1-0 libayatana-appindicator3-1 librsvg2-2

Fedora:

sudo dnf install gtk3 webkit2gtk4.1 libayatana-appindicator3 librsvg2

Arch Linux:

sudo pacman -S gtk3 webkit2gtk-4.1 libayatana-appindicator-gtk3 librsvg

🍎 macOS Dependencies

Install the Xcode Command Line Tools:

xcode-select --install

🪟 Windows Dependencies

1. Visual Studio 2022: Install the C++ Build Tools.
2. WebView2: Most recent Windows versions include this by default. If not, install the WebView2 Runtime.

---

build by amit vaidya