nlp-viz-pro 1.0.0

A deterministic visualization planning engine.

nlp-viz-pro

A deterministic visualization planning engine. It transforms a natural language query and data schema into a JSON visualization plan.

Installation

pip install nlp-viz-pro

Usage

import pandas as pd
from nlp_viz_pro import generate_plan, render_chart

# 1. Define your schema
schema = [
    {"name": "Date", "dtype": "datetime"},
    {"name": "Sales", "dtype": "float"}
]

# 2. Generate the plan from natural language
query = "show sales trend over time"
plan = generate_plan(query, schema)
print(plan)
# Output:
# {
#   "chart_type": "line",
#   "x": "Date",
#   "y": "Sales", ...
# }

# 3. Create your data
df = pd.DataFrame({
    "Date": pd.date_range(start="2026-01-01", periods=5),
    "Sales": [100, 150, 130, 180, 200]
})

# 4. Render the interactive Plotly chart!
fig = render_chart(plan, df)
fig.show() # Opens interactive chart in your browser