Skip to content

README.md

Latest commit

 

History

History
68 lines (51 loc) · 1.86 KB

README.md

File metadata and controls

68 lines (51 loc) · 1.86 KB

YYWC — Your Year With Chat

Generate a shareable share card + a deep-dive HTML report from your ChatGPT or Claude data export.

  • Runs locally (no network required)
  • Export-based (you control the input)
  • Outputs report.html, summary.json, and share.svg
  • Auto-detects export format (ChatGPT or Claude)

Quickstart

ChatGPT

  1. Request a ChatGPT Data Export and download the .zip

  2. From this repo directory:

python3 -m yywc --export /path/to/chatgpt-export.zip --out out --year 2025 --redact
open out/report.html
open out/share.svg

Claude

  1. Request your Claude Data Export from Settings → Account → Export Data

  2. From this repo directory:

python3 -m yywc --export /path/to/claude-export.zip --out out --year 2025 --redact
open out/report.html
open out/share.svg

Common options

# All time
python3 -m yywc --export chatgpt-export.zip --out out --redact

# Keep extracted files in a folder you control (otherwise it uses a temp dir)
python3 -m yywc --export chatgpt-export.zip --extract-dir ./extracted --out out

# Only include user+assistant messages (skip system/tool)
python3 -m yywc --export chatgpt-export.zip --out out --role-scope user,assistant

Notes

  • Claude exports don't include model information, so the "Top Models" section will be empty for Claude data.
  • The tool auto-detects the export format based on the JSON structure.

PNG export (optional)

If you want a PNG (for platforms that dislike SVG), with ImageMagick:

cd out
magick -density 144 share.svg -background none share.png

Or:

rsvg-convert -w 1200 -h 900 -o share.png share.svg

Example input

There’s a tiny example export at examples/sample_export/conversations.json.

python3 -m yywc --export examples/sample_export --out out_example --year 2025
open out_example/report.html