chartcoach 0.1.4

Python package and CLI for the chartcoach visualization guideline catalog.

chartcoach

Python package and CLI for visualization design guidance.

chartcoach gives notebooks, scripts, command-line workflows, and agents access to the chartcoach Guideline Catalog. Use it to find chart guidance, read recommendations, cite sources, and query the catalog with DuckDB and LanceDB.

Read the full Python docs at docs.chartcoach.dev/python.

Install

uv add chartcoach

pip install chartcoach

Install chartcoach[index] for local search. Install chartcoach[mcp] when an agent needs MCP tools.

CLI

uvx chartcoach@latest catalog query --contains "pie chart" --limit 5 --format table

Python

from chartcoach import Catalog

catalog = Catalog.open()
catalog.guidelines().select("id", "title").head(5)

Query the catalog with DuckDB when a notebook or script needs SQL:

conn = catalog.duckdb()
conn.sql("select id, title from guidelines limit 5").pl()
conn.close()

Agents

Equip agents with chartcoach through chartcoach/skills.

npx skills add chartcoach/skills

Learn More

• 🌐 Browse chartcoach.
• 📚 Explore the Guideline Catalog.
• 🧭 Read the catalog docs.
• ✨ Read the agent docs.

License

MIT. See LICENSE.