$git clone https://github.com/llmsresearch/paperbanana---
| 1 | <!-- mcp-name: io.github.llmsresearch/paperbanana --> |
| 2 | <table align="center" width="100%" style="border: none; border-collapse: collapse;"> |
| 3 | <tr> |
| 4 | <td width="220" align="left" valign="middle" style="border: none;"> |
| 5 | <img src="https://dwzhu-pku.github.io/PaperBanana/static/images/logo.jpg" alt="PaperBanana Logo" width="180"/> |
| 6 | </td> |
| 7 | <td align="left" valign="middle" style="border: none;"> |
| 8 | <h1>PaperBanana</h1> |
| 9 | <p><strong>Automated Academic Illustration for AI Scientists</strong></p> |
| 10 | <p> |
| 11 | <a href="https://github.com/llmsresearch/paperbanana/actions/workflows/ci.yml"><img src="https://github.com/llmsresearch/paperbanana/actions/workflows/ci.yml/badge.svg" alt="CI"/></a> |
| 12 | <a href="https://pypi.org/project/paperbanana/"><img src="https://img.shields.io/pypi/dm/paperbanana?label=PyPI%20downloads&logo=pypi&logoColor=white" alt="PyPI Downloads"/></a> |
| 13 | <a href="https://huggingface.co/spaces/llmsresearch/paperbanana"><img src="https://img.shields.io/badge/Demo-HuggingFace-yellow?logo=huggingface&logoColor=white" alt="Demo"/></a> |
| 14 | <a href="https://colab.research.google.com/github/llmsresearch/paperbanana/blob/main/notebooks/PaperBanana_Colab_Quickstart.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"/></a> |
| 15 | <br/> |
| 16 | <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10%2B-blue?logo=python&logoColor=white" alt="Python 3.10+"/></a> |
| 17 | <a href="https://arxiv.org/abs/2601.23265"><img src="https://img.shields.io/badge/arXiv-2601.23265-b31b1b?logo=arxiv&logoColor=white" alt="arXiv"/></a> |
| 18 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?logo=opensourceinitiative&logoColor=white" alt="License: MIT"/></a> |
| 19 | <br/> |
| 20 | <a href="https://pydantic.dev"><img src="https://img.shields.io/badge/Pydantic-v2-e92063?logo=pydantic&logoColor=white" alt="Pydantic v2"/></a> |
| 21 | <a href="https://typer.tiangolo.com"><img src="https://img.shields.io/badge/CLI-Typer-009688?logo=gnubash&logoColor=white" alt="Typer"/></a> |
| 22 | <a href="https://ai.google.dev/"><img src="https://img.shields.io/badge/Gemini-Free%20Tier-4285F4?logo=google&logoColor=white" alt="Gemini Free Tier"/></a> |
| 23 | </p> |
| 24 | </td> |
| 25 | </tr> |
| 26 | </table> |
| 27 | |
| 28 | --- |
| 29 | |
| 30 | > **Disclaimer**: This is an **unofficial, community-driven open-source implementation** of the paper |
| 31 | > *"PaperBanana: Automating Academic Illustration for AI Scientists"* by Dawei Zhu, Rui Meng, Yale Song, |
| 32 | > Xiyu Wei, Sujian Li, Tomas Pfister, and Jinsung Yoon ([arXiv:2601.23265](https://arxiv.org/abs/2601.23265)). |
| 33 | > This project is **not affiliated with or endorsed by** the original authors or Google Research. |
| 34 | > The implementation is based on the publicly available paper and may differ from the original system. |
| 35 | |
| 36 | An agentic framework for generating publication-quality academic diagrams and statistical plots from text descriptions. Supports OpenAI (GPT-5.2 + GPT-Image-1.5), Azure OpenAI / Foundry, Google Gemini, and Atlas Cloud providers. |
| 37 | |
| 38 | - Two-phase multi-agent pipeline with iterative refinement |
| 39 | - Multiple VLM and image generation providers (OpenAI, Azure, Gemini, Atlas Cloud) |
| 40 | - Input optimization layer for better generation quality |
| 41 | - Auto-refine mode and run continuation with user feedback |
| 42 | - CLI, Python API, and MCP server for IDE integration |
| 43 | - **Batch generation** from a manifest file (YAML/JSON) for multiple diagrams in one run |
| 44 | - **Batch plots** — `paperbanana plot-batch` runs many statistical plots from one manifest (CSV/JSON per item) |
| 45 | - **PDF inputs** for methodology context (optional `paperbanana[pdf]` / PyMuPDF), with per-page selection |
| 46 | - **PaperBanana Studio** — local Gradio web UI (`paperbanana studio`) for diagrams, plots, evaluation, batch, and run browser |
| 47 | - Claude Code skills for `/generate-diagram`, `/generate-plot`, and `/evaluate-diagram` |
| 48 | |
| 49 | <p align="center"> |
| 50 | <img src="assets/img/hero_image.png" alt="PaperBanana takes pap |