PaperBanana generates academic methodology diagrams and statistical plots from text descriptions and data. It is an unofficial community implementation of the paper "PaperBanana: Automating Academic Illustration for AI Scientists", not affiliated with the original authors or Google Research, and may differ from the system the paper describes.
Generation runs as a multi-agent pipeline of up to seven agents. An optional input optimizer structures raw methodology text and turns a vague caption into a precise visual specification. A retriever then picks reference figures from a curated set of 13 methodology diagrams, a planner writes a textual description of the target figure from those examples, and a stylist adjusts it to venue style guidelines. A visualizer renders the image and a critic compares it with the source context and revises the description, repeating for a fixed number of rounds or until the critic is satisfied. Statistical plots are rendered from model-written matplotlib code, so they need no image-generation provider.
Beyond single figures, it can plan and generate a figure package for a whole paper, run batches from a YAML or JSON manifest, stitch panels into a labeled composite figure, polish an existing figure against a venue style guide, and score a generated diagram against a human reference using a vision-language model as judge. It runs as a CLI, a Python API, a local Gradio web UI, an MCP server, and a GitHub Action that keeps an Overleaf paper's methodology figure in sync with its text.
| Component | Provider | Default model |
|---|---|---|
| Planning and critique (VLM) | OpenAI | gpt-5.2 |
| Image generation | OpenAI | gpt-image-1.5 |
| VLM | Google Gemini | gemini-2.5-flash |
| Image generation | Google Gemini | gemini-3-pro-image-preview |
| VLM | Atlas Cloud | DeepSeek-V3-0324 |
| Image generation | Atlas Cloud | gpt-image-2 |
| VLM or image | OpenRouter | any supported model |
Features
- Multi-agent pipeline: retriever, planner, stylist, visualizer, and critic agents plan a figure, render it, and refine it over several rounds
- Input optimization: parallel context enrichment and caption sharpening turn raw methodology text into a diagram-ready specification
- Statistical plots: CSV or JSON data plus an intent string produce a plot rendered through generated matplotlib code
- Run continuation: a previous run can be resumed with user feedback for the critic
- Venue style packs: built-in NeurIPS, ICML, ACL, and IEEE styles, plus custom packs with their own style guides and aspect ratios
- Batch and composite figures: manifests generate many diagrams or plots in one run and can stitch panels into a labeled multi-panel figure
- Full-paper orchestration: parses a paper in text, Markdown, or PDF, plans its figures, and writes a package with images, LaTeX, and captions
- Evaluation: compares a generated diagram with a human reference on faithfulness, readability, conciseness, and aesthetics
- Figure polish: audits an existing figure against a venue style guide and applies up to 10 suggested edits
- MCP server and skills: eleven MCP tools for diagram, plot, batch, and evaluation work, plus three Claude Code skills
- Overleaf sync: a GitHub Action regenerates the methodology figure from the paper's LaTeX source and commits it back
- Multiple providers: OpenAI, Azure OpenAI, Google Gemini, Atlas Cloud, and OpenRouter for both planning and image generation
