yapplotlib 0.1.0

A lightweight matplotlib plugin for rendering chat transcripts.

yapplotlib

A matplotlib plugin for rendering chat transcripts as matplotlib figures.

Instead of scrolling through this...

[
  {
    "role": "user",
    "content": "Have you heard of yapplotlib?"
  },
  {
    "role": "assistant",
    "content": "Yes! It's a matplotlib plugin for rendering chat logs as figures."
  },
  {
    "role": "user",
    "content": "That's quite meta."
  },
  {
    "role": "assistant",
    "content": "Indeed."
  }
]

...see it how your brain is used to.

Designed for embedding LLM conversations in academic papers, slides, and notebooks as native matplotlib subplots.

Installation

uv add yapplotlib
# or
pip install yapplotlib

Quick start

import yapplotlib

messages = [
    {'role': 'system',    'content': 'You are a helpful assistant.'},
    {'role': 'user',      'content': 'What is the capital of France?'},
    {'role': 'assistant', 'content': 'The capital of France is Paris.'},
]

fig, ax = yapplotlib.chatplot(messages, style='paper')
fig.savefig('chat.pdf', bbox_inches='tight')

Themes

Theme	Description
'default'	WhatsApp-style green/white, sans-serif
'paper'	Greyscale, serif — survives black-and-white printing
'dark'	Dark background for slides and web
'minimal'	Outline only, no fill

---

For embedding, options, and customisation see the full documentation.