ChartGen AI Chart Generator
AI-powered chart generator that creates professional visualizations through natural language. Built on ChartGen AI engine.
Overview
Transform your data into stunning, interactive charts with simple natural language commands. No coding required - just describe the chart you want, and ChartGen AI generates it instantly.
This skill supports Text-to-Chart, Text-to-SQL, and Text-to-Data analysis. Simply provide Excel/CSV files or JSON data, describe your visualization needs in plain language, and get interactive ECharts visualizations, structured analysis reports, and AI-driven insights.
Powered by ChartGen AI engine, supporting multiple chart types including bar, line, pie, scatter, area, and more. Optimized for business analytics and data storytelling.
API Service: This skill uses the ChartGen API service hosted at chartgen.ai. All data is sent to https://chartgen.ai/api/platform_api/ for processing.
Quick Start
1. Apply for an API Key
You can easily create and manage your API Key at chartgen.ai. To begin with, you need to register for an account.
Steps:
- 1. Visit chartgen.ai and sign up for an account
- Access the API management dashboard
- Create a new API and set the credit consumption limit
- Copy the API Key for use
2. Configure Environment Variable
CODEBLOCK0
3. Run Scripts
CODEBLOCK1
Credit Rules
- - Calling a single tool consumes 20 credits
- You get 200 free credits per month for free accounts
- When credits run out, you can purchase more or upgrade your account on the chartgen.ai Billing page
Scripts Reference
| Script | Function | Use Case |
|---|
| INLINECODE1 | Chart Generation | Text-to-Chart, create bar/line/pie/scatter charts |
| INLINECODE2 |
Data Analysis | Statistics, filtering, aggregation, calculation |
|
data_interpretation.py | Insight Generation | Trend analysis, pattern discovery, report generation |
Parameters
Common Parameters
| Parameter | Required | Description |
|---|
| INLINECODE4 | Yes | Natural language query statement |
| INLINECODE5 |
No | Local file path (.xlsx/.xls/.csv), mutually exclusive with --json |
|
--json | No | JSON data (string or file path), mutually exclusive with --file |
Visualization Specific Parameters
| Parameter | Description |
|---|
| INLINECODE7 | Output HTML file path (defaults to /tmp/openclaw/charts/) |
Data Format
File Format
Supports .xlsx, .xls, .csv Excel and CSV files.
Note: Only one of --file or --json is needed. If both are provided, --file takes precedence. File types support both row-metric-column data files and column-metric-row data files.
JSON Format
JSON data should be an array format, where each element is a row of data:
CODEBLOCK2
Or pass via file:
CODEBLOCK3
Usage Examples
Chart Generation (Text-to-Chart)
CODEBLOCK4
Data Analysis
CODEBLOCK5
Insight Generation
CODEBLOCK6
Supported Chart Types
- - Bar Chart / Stacked Bar Chart
- Line Chart / Area Chart
- Pie Chart / Donut Chart
- Scatter Plot
- And more...
Output Description
Chart Generation
- 1. Console Output: ECharts configuration JSON
- HTML File: Interactive chart that can be opened in any browser
Data Analysis & Insight Generation
Returns Markdown format text results, including analysis conclusions, data tables, and insights.
Error Handling
Common errors and solutions:
| Error Message | Cause | Solution |
|---|
| INLINECODE11 | Environment variable not set | INLINECODE12 |
| INLINECODE13 |
Request timeout | Check network connection and retry |
|
File not found | File does not exist | Check if file path is correct |
|
credits are insufficient | Insufficient credits | Recharge or contact administrator |
Technical Details
- - API Base URL: INLINECODE16
- Authentication: Header INLINECODE17
- Request Format: JSON
- Timeout: 60 seconds
- Required Environment Variable: INLINECODE18
See scripts/chartgen_api.py for implementation details.
Privacy Notice
Data sent to remote API: This skill reads your provided data files (CSV/XLSX/JSON), base64-encodes them, and sends them to the ChartGen API at https://chartgen.ai/api/platform_api/ for analysis and chart generation. Your data will leave your machine.
Recommendations:
- - Do not upload sensitive or regulated data
- Use a dedicated API key with limited scope/credits
- Review the privacy practices at chartgen.ai before use
ChartGen AI图表生成器
基于AI的图表生成器,可通过自然语言创建专业可视化图表。基于ChartGen AI引擎构建。
概述
通过简单的自然语言指令,将数据转化为惊艳的交互式图表。无需编码——只需描述您想要的图表,ChartGen AI即可即时生成。
本技能支持文本转图表、文本转SQL和文本转数据分析。只需提供Excel/CSV文件或JSON数据,用自然语言描述您的可视化需求,即可获得交互式ECharts可视化图表、结构化分析报告和AI驱动的洞察。
由ChartGen AI引擎驱动,支持柱状图、折线图、饼图、散点图、面积图等多种图表类型。专为商业分析和数据叙事优化。
API服务:本技能使用托管于chartgen.ai的ChartGen API服务。所有数据将发送至https://chartgen.ai/api/platformapi/进行处理。
快速开始
1. 申请API密钥
您可以在chartgen.ai轻松创建和管理您的API密钥。首先,您需要注册一个账户。
步骤:
- 1. 访问chartgen.ai并注册账户
- 进入API管理面板
- 创建新的API并设置额度消耗限制
- 复制API密钥以供使用
2. 配置环境变量
bash
export CHARTGENAPIKEY=your-api-key-here
3. 运行脚本
bash
生成图表(文本转图表)
python scripts/data_visualization.py --query 绘制按区域划分的销售额柱状图 --file sales.xlsx
数据分析
python scripts/data_analysis.py --query 计算各区域总销售额 --file sales.xlsx
数据解读
python scripts/data_interpretation.py --query 分析销售趋势 --file sales.xlsx
额度规则
脚本参考
| 脚本 | 功能 | 使用场景 |
|---|
| datavisualization.py | 图表生成 | 文本转图表,创建柱状图/折线图/饼图/散点图 |
| dataanalysis.py |
数据分析 | 统计、筛选、聚合、计算 |
| data_interpretation.py | 洞察生成 | 趋势分析、模式发现、报告生成 |
参数
通用参数
| 参数 | 必填 | 描述 |
|---|
| --query | 是 | 自然语言查询语句 |
| --file |
否 | 本地文件路径(.xlsx/.xls/.csv),与--json互斥 |
| --json | 否 | JSON数据(字符串或文件路径),与--file互斥 |
可视化专用参数
| 参数 | 描述 |
|---|
| --output, -o | 输出HTML文件路径(默认为/tmp/openclaw/charts/) |
数据格式
文件格式
支持.xlsx、.xls、.csv格式的Excel和CSV文件。
注意:只需提供--file或--json中的一种。如果两者都提供,--file优先。文件类型支持行-指标-列数据文件和列-指标-行数据文件。
JSON格式
JSON数据应为数组格式,每个元素为一行数据:
json
[
{name: 产品A, sales: 1000, region: 东部},
{name: 产品B, sales: 1500, region: 北部},
{name: 产品C, sales: 800, region: 南部}
]
或通过文件传递:
bash
python scripts/data_visualization.py --query 绘制图表 --json data.json
使用示例
图表生成(文本转图表)
bash
柱状图
python scripts/data_visualization.py --query 绘制按产品划分的销售额柱状图 --file sales.xlsx
折线图
python scripts/data_visualization.py --query 绘制销售趋势折线图 --file trends.xlsx
饼图
python scripts/data_visualization.py --query 绘制按区域划分的销售额饼图 --file sales.xlsx
散点图
python scripts/data_visualization.py --query 绘制价格与数量的散点图 --file data.xlsx
保存到指定路径
python scripts/data_visualization.py --query 绘制柱状图 --file data.xlsx -o /path/to/chart.html
数据分析
bash
统计计算
python scripts/data_analysis.py --query 计算各区域的总销售额和平均销售额 --file sales.xlsx
数据筛选
python scripts/data_analysis.py --query 筛选销售额大于1000的产品 --file sales.xlsx
排序
python scripts/data_analysis.py --query 按销售额降序排序 --file sales.xlsx
洞察生成
bash
趋势分析
python scripts/data
interpretation.py --query 分析月度销售趋势 --file monthlysales.xlsx
异常检测
python scripts/data_interpretation.py --query 查找并解释数据中的异常 --file data.xlsx
综合解读
python scripts/data_interpretation.py --query 提供包含关键洞察的综合分析 --file report.xlsx
支持的图表类型
- - 柱状图 / 堆叠柱状图
- 折线图 / 面积图
- 饼图 / 环形图
- 散点图
- 更多...
输出说明
图表生成
- 1. 控制台输出:ECharts配置JSON
- HTML文件:可在任何浏览器中打开的交互式图表
数据分析与洞察生成
返回Markdown格式的文本结果,包括分析结论、数据表格和洞察。
错误处理
常见错误及解决方案:
| 错误信息 | 原因 | 解决方案 |
|---|
| CHARTGENAPIKEY not set | 环境变量未设置 | export CHARTGENAPIKEY=your-key |
| API request timeout |
请求超时 | 检查网络连接并重试 |
| File not found | 文件不存在 | 检查文件路径是否正确 |
| credits are insufficient | 额度不足 | 充值或联系管理员 |
技术细节
- - API基础URL:https://chartgen.ai/api/platformapi/
- 认证方式:请求头 Authorization:
- 请求格式:JSON
- 超时时间:60秒
- 必需环境变量:CHARTGENAPI_KEY
实现细节请参见scripts/chartgen_api.py。
隐私声明
发送至远程API的数据:本技能会读取您提供的数据文件(CSV/XLSX/JSON),进行base64编码后发送至ChartGen API(https://chartgen.ai/api/platform_api/)进行分析和图表生成。您的数据将离开您的机器。
建议:
- - 请勿上传敏感或受监管的数据
- 使用具有有限范围/额度的专用API密钥
- 使用前请查看chartgen.ai的隐私实践