doc_id: readme version: "0.3" status: experimental updated: 2026-11-02 language: en

GenUI for Apache ECharts

简体中文

GenUI for Apache ECharts (formerly ChartNexus) is experimental infrastructure for language models and agents: versioned JSON chart contracts, validation, browser/SVG rendering, GenUI adapters, CLI/MCP tools and resources for RAG or training workflows. It is an independent project; compatibility does not imply upstream endorsement.

The existing @chartnexus/* workspace package names, CLI commands and chartnexus:// MCP resource identifiers remain unchanged for compatibility. They do not indicate npm publication or ownership of an npm scope.

The 0.3 intent profile includes bar, line, pie, scatter, combo, funnel, heatmap, radar, tree, Sankey and host-registered maps. Light/dark themes, transparent chat backgrounds and five detail levels are available. The retained guarded native0.1 profile supports a restricted ECharts option subset. OpenUI Lang, A2UI v0.9, COSUI JSON and COSUI Marklang have pinned real-host tests; support is profile/version-specific.

All eleven packages remain private and unpublished. Model quality, installed packages and UI hosts have separate evidence; see the support matrix, contracts/migration, and evaluation/distribution guide. Model-independent architecture does not establish every-model success.

Related MCP server: Server MCP

Start here

• Quick start: run and embed

• Chart, theme and example catalog

• Model, agent, MCP and retrieval guide

• Product responsibility boundary

• AI text index

Local preview

Use Node22.22.3 or the tested Node24 runtime and pnpm11.25.0:

pnpm install --frozen-lockfile --ignore-scripts
pnpm check
pnpm dev
# For the localhost Ollama playground:
pnpm dev:ollama

The default preview is http://127.0.0.1:5173/; host demos include /openui.html, /a2ui.html, /cosui.html and /marklang.html. The Ollama page is http://127.0.0.1:5180/ollama.html and requires a running local Ollama service with an installed model. See the development guide for browser/package checks and limits.

Repository: diysimon/genui-for-echarts. License: Apache-2.0.

Reading order

Read the charter and architecture, then initialization, spec execution, coding standards, and pipelines. Read agent guidance before implementation.

Standards index

• Project charter and scope

• Technical architecture and design

• Coding standards and engineering requirements

• Contracts, data, and compatibility specification

• Spec-driven execution workflow

• Project initialization plan

• CI/CD pipelines and gates

• Testing, evaluation, and acceptance

• Model, agent, RAG, and training resources

• Bilingual documentation and governance

• Security and reliability requirements

• Implementation roadmap and dependencies

• Sources, decisions, and open questions

Copyable templates

• Feature spec template

• Tasks and execution evidence template

• RFC template

• Pull request template

• Release checklist template

Contribution and security

Contributing · Security reporting status · Document manifest

CLI and MCP integration guide

Model and agent entry · Offline evaluation baseline

Try the local Ollama chart playground