Installation

Installation

Requirements

• Python 3.10 or higher
• A Google Gemini API key (free from Google AI Studio)

Standard Installation

git clone https://github.com/llmsresearch/paperbanana.git
cd paperbanana
pip install -e ".[google]"

First-Time Setup

Run the setup wizard to configure your API key:

paperbanana setup

This opens your browser to Google AI Studio, where you can create a free API key. The wizard saves it to a .env file in the project root.

Manual Setup

If you prefer to set up manually:

cp .env.example .env

Edit .env and add your key:

GOOGLE_API_KEY=your-key-here

Development Installation

For contributors:

pip install -e ".[dev,google]"

This installs additional dependencies for testing (pytest) and linting (ruff).

Verify Installation

paperbanana generate \
  --input examples/sample_inputs/transformer_method.txt \
  --caption "Overview of our encoder-decoder architecture with sparse routing"

If you see output saved to outputs/run_<timestamp>/final_output.png, everything is working.

MCP Server

See MCP Server Setup for IDE integration.