ez-chart

n8n community node for generating charts using QuickChart.io API. Supports bar, line, pie, radar charts with automatic chart type selection based on data and intent. Perfect for AI agents to create visualizations.

Package Information

Released: 8 mo ago
Downloads: 7 weekly / 24 monthly
Latest Version: 0.1.1
Author: Quan Nguyen

Available Nodes

Documentation generating…

EzChart icon
EzChart
Generate charts and data visualizations using QuickChart.io API. Creates bar charts, line charts, pie charts, radar charts, and more. Returns image URL or base64 data. Perfect for creating visual reports, dashboards, and data presentations.

Documentation

n8n-nodes-ez-chart

An n8n community node for generating charts and data visualizations using the QuickChart.io API. Designed for AI agent integration with comprehensive tool descriptions.

EzChart Node
License

Features

  • AI Agent Ready - usableAsTool: true with detailed descriptions for every parameter
  • Auto Chart Selection - Specify your intent (compare, trend, composition, etc.) and the best chart type is selected automatically
  • Multiple Data Formats - Key-value objects, number arrays, object arrays, multi-series, raw JSON
  • 6 Style Presets - Minimal, Business, Dark, Vibrant, Accessible, Print
  • Multiple Output Formats - PNG, SVG, JPG, WebP
  • Self-Hosted Support - Works with custom QuickChart instances via configurable base URL

Supported Chart Types

Chart Type Best For
Bar (Vertical) Comparing values across categories
Bar (Horizontal) Long labels, rankings
Line Trends over time
Area Volume over time
Pie Proportions (2-7 categories)
Doughnut Modern alternative to pie
Radar Multi-dimensional comparison
Polar Area Equal-angle varying radius
Scatter Relationships between variables

Operations

Create Chart (Simple)

Provide data and a visualization intent. The node automatically selects the best chart type.

Intents:

  • compare - Compare values across categories (bar, horizontal bar)
  • trend - Show changes over time (line, area)
  • composition - Parts of a whole (pie, doughnut)
  • distribution - Data distribution (bar)
  • relationship - Correlation between variables (scatter)
  • progress - Progress toward a goal (gauge, progress bar)

Create Chart (Advanced)

Full control over chart type, labels, datasets, and styling.

Analyze Data

Get chart type recommendations with confidence scores before creating a chart.

Data Formats

// Key-Value Object
{"January": 100, "February": 150, "March": 120}

// Array of Numbers
[10, 20, 30, 40, 50]

// Array of Objects
[{"label": "Product A", "value": 30}, {"label": "Product B", "value": 45}]

// Multi-Series
{"Revenue": [100, 150, 120], "Costs": [80, 90, 85]}

Style Presets

Preset Description
minimal Clean, modern look with subtle colors
business Professional with data labels, blue tones
dark Dark background with bright colors
vibrant Colorful and eye-catching
accessible WCAG compliant, high contrast
print Grayscale-friendly

Installation

In n8n (Community Nodes)

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter n8n-nodes-ez-chart
  4. Agree to the risks and install

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-ez-chart

Restart n8n after installation.

Credentials (Optional)

The node works without credentials using the free QuickChart.io API. To configure:

  • Base URL - Custom QuickChart instance URL (default: https://quickchart.io)
  • API Key - Optional key for QuickChart professional accounts

Output

The node returns:

{
  "success": true,
  "url": "https://quickchart.io/chart?c=...",
  "width": 600,
  "height": 400,
  "format": "png",
  "chartType": "bar",
  "intent": "compare",
  "style": "minimal"
}

With Return Base64 option enabled:

{
  "success": true,
  "base64": "iVBORw0KGgo...",
  "dataUri": "data:image/png;base64,iVBORw0KGgo...",
  "mimeType": "image/png"
}

AI Agent Usage

This node is designed for use with n8n's AI Agent node. The usableAsTool: true flag makes it available as a tool that AI agents can invoke to generate charts during conversations.

Example agent prompt:

"Create a bar chart comparing Q1-Q4 sales: Q1=100, Q2=150, Q3=120, Q4=200. Use a business style."

Development

# Install dependencies
npm install

# Build
npm run build

# Development with watch
npm run dev

# Lint
npm run lint

License

MIT

Discussion