paper-orchestra README

The project's README from github.com/google-research/paper-orchestra. As one markdown file: README.md.

🎻 PaperOrchestra: A Multi-Agent Framework for Automated AI Research Paper Writing

Yiwen Song1, Yale Song1, Tomas Pfister1, and Jinsung Yoon1
1Google Cloud AI Research


PaperOrchestra is a multi-agent framework for automated AI research paper writing. It flexibly transforms unconstrained pre-writing materials (ideas and experimental logs) into submission-ready LaTeX manuscripts, including comprehensive literature synthesis and generated visuals, such as plots and conceptual diagrams.

Acting like an orchestrated team of specialized agents, it handles outline generation, literature review, section writing, content refinement, and plotting to close the gap between raw research materials and submission ready papers.

PaperOrchestra Overview

Key Features

Installation

  1. Environment Setup: The project relies on a Conda environment named paper_orchestra. You can set up a similar environment with Python 3.11 and install the required dependencies.

    conda create -n paper_orchestra python=3.11
    conda activate paper_orchestra
    pip install -r requirements.txt
    
  2. Environment Variables: Create a .env file in the root of the project and add your API keys:

    # Add keys if you have them, otherwise leave them empty
    # You need to specify related keys if you want to use the model
    # For example, if you want to use Gemini models, you need to specify either VERTEX_AI_PROJECT and VERTEX_AI_LOCATION, or GEMINI_API_KEY
    # If you want to use OpenAI models, you need to specify OPENAI_API_KEY
    
    SEMANTIC_SCHOLAR_API_KEY=your_semantic_scholar_api_key
    OPENAI_API_KEY=your_openai_api_key
    VERTEX_AI_PROJECT=your_vertex_ai_project
    VERTEX_AI_LOCATION=your_vertex_ai_location
    GEMINI_API_KEY=your_gemini_api_key
    
    # if you want to run demo and send emails to yourself at the end, set these 2 fields as well
    SMTP_EMAIL=your_email
    SMTP_PASSWORD=your_password
    

Dataset

The dataset used for paper generation is not included in this code repository. It will be released separately at a later date. Once available, you should download the dataset and place it under the datasets/ directory.

Usage

You can run the paper generation pipeline using the provided bash script or directly via the Python CLI.

Using the Bash Script

./paper_writing_cli.sh

Using the Python CLI directly

python paper_writing_cli.py \
  --raw_materials_dir /path_to_your_raw_materials/ \
  --latex_template_dir /path_to_your_latex_template/ \
  --output_dir /path_to_your_output_folder/ \
  --use_plotting true

Key Arguments

Interactive Demo

We provide an interactive Streamlit demo for the paper generation pipeline. For instructions on how to run and use it, please refer to the README.md in the frontend directory.

Project Structure

Citation

If you find this repo or our paper helpful, please cite it as follows:

@article{song2026paperorchestra,
  title={PaperOrchestra: A Multi-Agent Framework for Automated AI Research Paper Writing},
  author={Song, Yiwen and Song, Yale and Pfister, Tomas and Yoon, Jinsung},
  journal={arXiv preprint arXiv:2604.05018},
  year={2026}
}

Disclaimer

This is not an officially supported Google product.

paper-orchestra (google-research/paper-orchestra)

Searching Database…

What is this?PaperOrchestra is a multi-agent framework that turns your raw research materials (ideas and experiment logs) into a submission-ready LaTeX paper, including literature synthesis and generated figures.
Is it a finished paper or a tool that writes one?It is a tool. A team of specialized agents (outline, literature review, section writing, refinement, plotting) runs on your own materials and produces the draft.
How do I get it running?Create a Conda env named paperorchestra with Python 3.11 and install the dependencies, add your API keys to a .env file in the project root, then run the bash script or the Python CLI with the raw materials dir and the LaTeX template dir.
What do I need before starting?Conda, Python 3.11, and API keys for the LLM providers you use, stored in the .env file.
Does the repo include the dataset?No. The dataset used for paper generation is not in this repository and will be released separately later. You would place it under the datasets/ directory once it is available.
Is there a visual interface, not just the CLI?Yes, there is an interactive Streamlit demo of the pipeline. Its run instructions are in the README inside the frontend directory.
Does it include a way to evaluate the output?Yes, the autoraters/ folder contains scripts for automated evaluation of the generated papers.
Is it an official Google product?The authors are from Google Cloud AI Research, but the README states it is not an officially supported Google product.
Size
2 MB
Stars
3K
Updated
CommitNov 15
Age
6mo
Commits · 90 Days