Skip to content
Back to search

flint-chart

🪄 Flint is a visualization language that lets AI agents reliably create expressive, good-looking charts from simple, human-editable chart specs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/microsoft/flint-chart with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/microsoft/flint-chart'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoft--flint-chart/badge.svg)](/listings/microsoft--flint-chart)

HTML

<a href="/listings/microsoft--flint-chart"><img src="/api/listings/microsoft--flint-chart/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Use Flint in your JavaScript/TypeScript codebase
npm install flint-chart

# For agents and MCP clients
npx -y flint-chart-mcp

<p><sub><span style="color: #6a737d;">Python package: to be released. The current Python port is a source-only preview in this repo.</span></sub></p>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 195 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1><img src="assets/flint-logo.svg" alt="" width="42" align="absmiddle"> Flint: A Visualization Language for the AI Era</h1>
  2. [![npm: flint-chart](https://img.shields.io/npm/v/flint-chart.svg?label=npm%3A%20flint-chart)](https://www.npmjs.com/package/flint-chart)
  3. [![npm: flint-chart-mcp](https://img.shields.io/npm/v/flint-chart-mcp.svg?label=npm%3A%20flint-chart-mcp)](https://www.npmjs.com/package/flint-chart-mcp)
  4. [![arXiv: 2607.20775](https://img.shields.io/badge/arXiv-2607.20775-b31b1b.svg)](https://arxiv.org/abs/2607.20775)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. [![Discord](https://img.shields.io/badge/discord-chat-green?logo=discord)](https://discord.gg/hnm4Y8YX8)
  7. [**Project site**](https://microsoft.github.io/flint-chart/) ·
  8. [**中文主页**](https://microsoft.github.io/flint-chart/#/zh) ·
  9. [**MCP server**](https://microsoft.github.io/flint-chart/#/mcp) ·
  10. [**Gallery**](https://microsoft.github.io/flint-chart/#/gallery)
  11. Flint lets AI agents **reliably create expressive, good-looking and interactive
  12. charts** from simple, human-editable specs. Good-looking charts usually take
  13. verbose low-level settings that tangle visual, style and interaction logic
  14. together; Flint moves that work into a compiler, so the spec stays short.
  15. Use it as an [MCP server](https://microsoft.github.io/flint-chart/#/mcp) with your
  16. agent, or as an [npm library](https://www.npmjs.com/package/flint-chart) in your
  17. app. Flint supports **52 chart types across 5 rendering backends**
  18. ([Vega-Lite](https://vega.github.io/vega-lite/), [ECharts](https://echarts.apache.org/),
  19. [Chart.js](https://www.chartjs.org/), [Plotly](https://plotly.com/javascript/) and
  20. native Excel charts), with **14 preset themes** and **23 interaction presets**.
  21. <p align="center">
  22. <a href="https://microsoft.github.io/flint-chart/#/gallery"><img src="docs/figs/flint-chart-wall.png" alt="A wall of charts drawn by Flint from real data, each in a different preset theme: a globe of the Ring of Fire, a route map of Magellan's voyage, a US choropleth, ridgelines, a calendar heatmap, a waterfall, violins, a radar, a bump chart, a population pyramid, and everyday bar, line, scatter, area and donut charts." width="100%"></a>
  23. </p>
  24. https://github.com/user-attachments/assets/c1cda0fa-3ea7-41af-b3fd-a127bc83d641
  25. <p align="center">
  26. <sub>🔊 Click the speaker icon for sound</sub>
  27. &nbsp;
  28. <a href="https://youtu.be/JAJy7ToczMs"><img src="https://img.shields.io/badge/Watch%20on-YouTube-FF0000?logo=youtube&logoColor=white" alt="Watch on YouTube" align="absmiddle"></a>
  29. </p>
  30. ## Updates
  31. - **November 15, 2026** — Flint 1.1 brings maps and layout: maps with
  32. customizable boundaries, globes, routes and labelled points, framed to their
  33. data; charts that fit their canvas on every backend; and annotations as
  34. captions beside what they name.
  35. ([release notes](https://github.com/microsoft/flint-chart/releases/tag/1.1))
  36. - **October 19, 2026** — Flint 1.0 introduces
  37. [Flint Interactive](https://microsoft.github.io/flint-chart/#/interactions):
  38. interaction presets, semantic events, and an interaction API that connects
  39. charts to your app.
  40. See the [changelog](CHANGELOG.md) for every release.
  41. ## Quick start
  42. ### With your agent (MCP server)
  43. Paste this into your agent, such as GitHub Copilot, Claude Code, Codex or Cursor.
  44. It adds the Flint MCP server and draws your first chart:
  45. ```text
  46. Help me set up Flint as an MCP server named "flint"!
  47. 1. Add it to my client config, using whichever option my client supports:
  48. - a local (stdio) server: npx -y flint-chart-mcp
  49. - the hosted server over HTTP: https://flint.data-formulator.ai/mcp
  50. 2. Verify the setup by listing the available Flint chart types.
  51. 3. Show me a fun first chart: how many moons each planet has, in a Flint theme you like.
  52. ```
  53. Then ask for charts in your own words, such as *"compare today's change for
  54. the Magnificent Seven stocks in Economist style, and let me hover to read each
  55. one"*. The agent opens a live chart in the conversation, or returns a PNG, an
  56. SVG or a backend-native spec. To set it up by hand, see the
  57. [MCP server guide](https://microsoft.github.io/flint-chart/#/mcp).
  58. <p align="center">
  59. <img src="docs/figs/flint-mcp-chat.png" alt="An agent chat where the user asks for global temperatures since 1880 in a newspaper style with brushing, and Flint answers with a live, interactive line chart." width="520">
  60. </p>
  61. ### In your app (npm library)
  62. ```bash
  63. npm install flint-chart
  64. ```
  65. ```tsx
  66. import type { ChartAssemblyInput } from 'flint-chart';
  67. import { FlintChart } from 'flint-chart/react';
  68. const spec: ChartAssemblyInput = {
  69. data: { values: [
  70. { Month: '2026-01', Users: 1200 },
  71. { Month: '2026-02', Users: 1800 },
  72. ] },
  73. semantic_types: { Month: 'YearMonth', Users: 'Quantity' },
  74. chart_spec: { chartType: 'Line Chart', encodings: { x: 'Month', y: 'Users' } },
  75. theme_spec: 'economist',
  76. interaction_spec: { interactions: [{ type: 'inspect-index' }] },
  77. };
  78. <FlintChart spec={spec} />
  79. ```
  80. `flint-chart` comes with every backend it draws with; React is an optional peer,
  81. needed only for `<FlintChart>`. Without React, `mountChart` from
  82. `flint-chart/interactive` mounts the same chart in any page, and
  83. `assembleVegaLite`, `assembleECharts`, `assembleChartjs`, `assemblePlotly` and
  84. `assembleExcel` compile a spec into each library's own. To have your coding agent
  85. build it, point it at Flint's
  86. [chart](agent-skills/flint-chart-author/SKILL.md) and
  87. [interaction](agent-skills/flint-interaction-author/SKILL.md) authoring skills.
  88. ## How it works
  89. A Flint spec is the data, semantic types, a chart spec, and optional theme and
  90. interaction specs. Instead of leaving the glue to you, the compiler resolves
  91. each part against the others and composes a complete spec for the backend.
  92. <p align="center">
  93. <img src="docs/figs/flint-compilation-pipeline.png" alt="A Flint spec with semantic types, theme and interaction compiled into a Vega-Lite spec and rendered as a temperature heatmap." width="100%">
  94. </p>
  95. - **Describe data with semantic types.** Fields carry types such as `Rank`,
  96. `YearMonth`, `Delta` or `Temperature`, with their domains and units, and the
  97. compiler infers parsing, scales, axes, formatting and colors from them.
  98. - **Build charts with library-agnostic chart specs.** Charts name a chart type
  99. and its encodings; the compiler sizes, spaces and labels them for their data,
  100. and the same spec renders on every backend.
  101. See the [gallery](https://microsoft.github.io/flint-chart/#/gallery).
  102. - **Unify the look with a theme spec.** Pick a preset such as the New York
  103. Times, the Economist or Swiss, or extend one with your brand:
  104. `{ extends: 'economist', id: 'our-brand', ink: { series: { single: '#6b3fa0' } } }`.
  105. See the [theme explorer](https://microsoft.github.io/flint-chart/#/themes) and
  106. the [Theme Lab](https://microsoft.github.io/flint-chart/#/theme-lab).
  107. - **Add interactions with an interaction spec.** Brushing, hover readouts,
  108. legend toggles and more; the compiler turns a reader's gestures into semantic
  109. events, so your app answers with high-level chart updates.
  110. See the [interaction gallery](https://microsoft.github.io/flint-chart/#/interactions/gallery)
  111. and [advanced interactions](https://microsoft.github.io/flint-chart/#/interactions/advanced).
  112. ## Documentation
  113. - [Project site](https://microsoft.github.io/flint-chart/): gallery, live editor, themes and interactions
  114. - [API reference](docs/api-reference.md), with backend references for
  115. [Vega-Lite](docs/reference-vegalite.md), [ECharts](docs/reference-echarts.md),
  116. [Chart.js](docs/reference-chartjs.md), [Plotly](docs/reference-plotly.md) and
  117. [Excel](docs/reference-excel.md)
  118. - [Theme guide](docs/theme-spec.md), [interaction spec](docs/interaction-spec.md)
  119. and [interaction API](docs/interaction-api.md)
  120. - [MCP server guide](https://microsoft.github.io/flint-chart/#/mcp) and [agent skills](agent-skills/)
  121. - [Paper on arXiv](https://arxiv.org/abs/2607.20775)
  122. A Python port is in preview as source in [`packages/flint-py`](packages/flint-py);
  123. its package is not yet released.
  124. ## Contributing
  125. Contributions are welcome, especially new
  126. [chart templates](docs/adding-a-chart-template.md) and
  127. [rendering backends](docs/adding-a-backend.md). See
  128. [CONTRIBUTING](.github/CONTRIBUTING.md), and the
  129. [development guide](docs/DEVELOPMENT.md) for setup, commands and the repository
  130. layout. Pick up an [issue](https://github.com/microsoft/flint-chart/issues), add
  131. a chart template or a theme, or share what you build.
  132. <a href="https://github.com/microsoft/flint-chart/graphs/contributors">
  133. <img src="https://contrib.rocks/image?repo=microsoft/flint-chart" alt="Contributors to Flint">
  134. </a>
  135. ## Community
  136. Join the [Flint Discord](https://discord.gg/hnm4Y8YX8) to ask questions, share
  137. your charts and follow releases.
  138. <details>
  139. <summary>Flint WeChat group</summary>
  140. <br>
  141. <img src="docs/figs/QR-code.png" alt="Flint WeChat user group QR code" width="160">
  142. </details>
  143. ## Code of conduct, security and trademarks
  144. This project has adopted the
  145. [Microsoft Open Source Code of Conduct](.github/CODE_OF_CONDUCT.md). See
  146. [SECURITY.md](.github/SECURITY.md) to report vulnerabilities.
  147. This project may contain trademarks or logos for projects, products, or services.
  148. Authorized use of Microsoft trademarks or logos is subject to and must follow
  149. [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
  150. Use of Microsoft trademarks or logos in modified versions of this project must not
  151. cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks
  152. or logos is subject to those third parties' policies.
  153. ## License
  154. [MIT](LICENSE) © Microsoft Corporation

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.