paperbanana-cn 2.0.1

English · 简体中文

Turn method descriptions and research data into scientific diagrams and statistical plots.
Keep the PaperBanana workflow; choose your own VLM, image service, interface language, aspect ratio, and resolution.

See it work

_{One real Studio run: configured input → live pipeline stages → completed result. No credentials or private endpoints are shown.}

Real outputs, not mockups

The methodology diagrams were generated and refined through the configured VLM and image roles. The statistical plot uses PaperBanana's deterministic plotting path; its values are synthetic demonstration data.

What V2 actually adds

Studio, CLI, and MCP resolve the same saved connections. API keys remain outside the repository, are never filled back into the browser, and are excluded from run metadata.

Start in 60 seconds

1. Launch the desktop Studio

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

uvx paperbanana-cn studio

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

2. Connect the two model roles

Open Settings → VLM connection, enter the protocol, Base URL, API key, exact model name, and timeout, then select Save and use. Repeat under Image connection.

[!TIP] The two roles may use the same relay or completely different services. Editing a saved connection does not activate it, and leaving the key field blank preserves the existing key.

3. Generate

Choose Methodology diagram, add the method content and communicative intent, select the aspect ratio and resolution, and run. The result canvas keeps the final figure, real output size, iteration history, and download actions together.

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

A workbench built around the result

Task inputs stay in the left work area. The result canvas is the visual center; completed logs collapse out of the way, while failed runs keep the input and expose the actionable error.

One scientific workflow

PaperBanana-CN does not maintain a second scientific pipeline. Retrieval, planning, candidate generation, critique, refinement, deterministic plotting, recovery, batch processing, orchestration, and vector export continue through the upstream PaperBanana workflow.

Use it your way

{
  "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

Output control without surprises

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

Each image adapter declares whether it accepts native tiers, explicit pixels, fixed presets, or a prompt hint. Studio shows the actual request size or native tier. It never silently crops, stretches, or substitutes an unsupported ratio.

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

paperbanana-cn connections add \
  --role vlm \
  --name "Primary VLM" \
  --provider openai \
  --base-url "https://vlm.example.com/v1" \
  --model "your-vlm-model" \
  --api-key-env VLM_API_KEY

V1 is preserved. V2 moves forward.

V2 is maintained on main as the paperbanana-cn distribution, paperbanana_cn Python module, and paperbanana-cn command. V1 remains available as a frozen historical release:

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

Project and community

PaperBanana-CN is maintained by mituan.

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

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

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