tufte-vdqi-plugin  by gnurio

AI agent data visualization enforcing Tufte's principles

Created 2 months ago
267 stars

Top 95.7% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This plugin empowers AI agents with data visualization skills grounded in Edward Tufte's principles from "The Visual Display of Quantitative Information" (VDQI). It automatically assesses, scores, and renders charts, stripping chartjunk, measuring lie factors, and producing clean SVGs. The target audience is AI developers and users seeking rigorous, scientifically sound, and aesthetically refined data representations.

How It Works

The project integrates Tufte's VDQI principles into AI agent workflows via two core skills: assess-graphical-excellence and render-tufte-chart. The former scores graphics against VDQI's nine criteria, identifies chartjunk species, computes lie factors, and suggests fixes. The latter generates SVG visualizations using Tufte's specific chart genres, such as Cleveland dot plots, small multiples, and range-frame scatterplots. All techniques are explicitly cited to VDQI, ensuring a rigorous, data-driven approach to visualization design.

Quick Start & Requirements

Installation involves adding the repository as a plugin source within Claude Desktop or an organization's settings. A paid Claude plan (Pro, Max, Team, or Enterprise) with Cowork enabled is a strict prerequisite.

Highlighted Details

  • Automated application of Tufte's VDQI principles, including lie factor measurement and chartjunk identification.
  • Support for Tufte-specific chart genres: time-series, small multiples, quartile plots, and range-frame scatterplots.
  • Includes helper scripts for monetary inflation adjustment (deflate.py) and generating Tufte-styled HTML pages (wrap_html.py).
  • Vendored MIT-licensed tufte-css typography bundle for clean HTML rendering.

Maintenance & Community

No specific details regarding contributors, sponsorships, partnerships, or community channels (e.g., Discord, Slack) are provided in the README.

Licensing & Compatibility

The README states inspiration from Tufte's work and that no text was reproduced. The tufte-css bundle is MIT licensed. However, the primary license for the gnurio/tufte-vdqi-plugin code itself is not explicitly stated, posing a potential adoption blocker. Compatibility is limited to paid Claude plans with Cowork enabled.

Limitations & Caveats

The plugin is exclusively dependent on Anthropic's Claude platform and requires a paid subscription. The inflation adjustment script (deflate.py) necessitates complete CPI data for all years, failing on missing entries. The absence of a clear primary license for the plugin's code requires further investigation.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
21 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.