PaperBanana CN README

English · 简体中文

PaperBanana-CN generates methodology diagrams from research descriptions and statistical plots from CSV or JSON data. It uses the PaperBanana scientific workflow and adds separate VLM and image-service connections, a Chinese Studio interface, and explicit aspect-ratio and resolution controls.

One run from input to figure

The recording follows a methodology-diagram run from submitted inputs to the completed result.

Before you start

You need Python 3.10-3.12, uv, and a desktop browser.

Each connection specifies its own protocol, Base URL, API key, model name, and timeout. The VLM and image roles may use the same service or two different services.

Quick start

1. Launch Studio

uvx paperbanana-cn studio

Open http://127.0.0.1:7860. uvx runs the package in an isolated environment and does not modify Debian or Ubuntu's system Python.

2. Add the model connections

Open Settings → VLM connection, fill in the service fields, and select Save and use. Repeat under Image connection before generating a methodology diagram.

Editing a saved connection does not activate it. An empty API-key field keeps the stored key. Studio does not fill stored keys back into the browser.

3. Generate a figure

Open Methodology diagram, provide the method content and figure caption, then choose an aspect ratio, resolution, and output format.

The same task from the CLI:

paperbanana-cn generate \
  --input method.txt \
  --caption "Overview of the proposed architecture" \
  --aspect-ratio 16:9 \
  --resolution 2K \
  --format png

What PaperBanana-CN adds

Separate VLM and image connections

The two model roles have independent protocol, Base URL, API key, model, and timeout settings. Studio, CLI, and MCP resolve the same saved connections. Saved profiles contain credential references; API keys remain outside the repository and run metadata.

Official APIs, OpenAI-compatible services, and Gemini-compatible services are supported. Provider specifics stay in the adapters rather than the scientific workflow.

Chinese and English Studio

The Studio interface, help text, validation, progress messages, and errors are available in Chinese and English. Changing the interface language does not rewrite prompts, paper text, or labels inside the generated figure.

Aspect ratios and resolution

Supported aspect ratios:

1:1 · 4:3 · 3:2 · 5:4 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16

Resolution tiers:

1K · 2K · 4K

Studio shows the request size or provider-native tier before generation. If an adapter cannot produce the selected combination, validation stops the request and reports the unsupported option.

Studio workflows

_{Methodology-diagram workspace}

_{Statistical-plot workspace using synthetic demonstration data}

CLI, MCP, Docker, and Colab

{
  "mcpServers": {
    "paperbanana-cn": {
      "command": "uvx",
      "args": ["paperbanana-cn", "mcp"]
    }
  }
}

docker run --rm -p 7860:7860 \
  -v paperbanana-cn-config:/home/paperbanana/.config/paperbanana-cn \
  -v paperbanana-cn-data:/home/paperbanana/.local/share/paperbanana-cn \
  -v paperbanana-cn-outputs:/work/outputs \
  ghcr.io/mituan-ai/paperbanana-cn:2.0.1 \
  studio --host 0.0.0.0

uv tool install paperbanana-cn
paperbanana-cn studio

git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync
uv run paperbanana-cn studio

V1 and upstream

V2 is maintained on main as the paperbanana-cn distribution, the paperbanana_cn Python module, and the paperbanana-cn command.

• Browse the frozen v1 branch
• Download the v1.0.0 release

The scientific figure-generation core is based on llmsresearch/paperbanana. PaperBanana-CN is an unofficial community implementation and is not affiliated with or endorsed by the upstream authors.

Community

PaperBanana-CN is maintained by mituan under the MIT License.

• Ask usage questions in Discussions.
• Report reproducible bugs in Issues.
• Report vulnerabilities through Private Vulnerability Reporting.
• Read CONTRIBUTING.md before opening a pull request.

git clone https://github.com/mituan-ai/PaperBanana-CN.git
cd PaperBanana-CN
uv sync --extra dev
uv run pytest tests/ -q
uv run ruff check paperbanana_cn/ mcp_server/ tests/ scripts/

Star history