google-research /paper-orchestra
PaperOrchestra is a multi-agent framework for automated AI research paper writing.
★ 2,034⑂ 317👁 18⑃ 37● 6▤ 0
2,034
stars
317
forks
18
watchers
37
prs
6
issues
0
releases
README
🎻 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.
Key Features
- Multi-Agent Pipeline: Orchestrates specialized agents (Outline, Literature Review, Section Writing, Content Refinement, Plotting) for end-to-end paper generation.
- Comprehensive Literature Synthesis: Automatically searches, prioritizes, and integrates relevant literature into the manuscript.
- Visuals Generation: Generates plots and supports the inclusion of conceptual diagrams.
- LaTeX Automation: Produces submission-ready LaTeX manuscripts adhering to target conference templates.
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.
bash
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:
env
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
bash
./paper_writing_cli.sh
Using the Python CLI directly
bash
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_yTop issues
#7Is the paper pipeline meant to be Gemini-only?2 comments · 2026-11-15#28سلام1 comments · 2026-11-16#23Streamlit demo drops uploaded figures: captions are never written to figures/info.json1 comments · 2026-11-16#25Image payloads are sent with a hardcoded MIME type: PNGs declared as image/jpeg to OpenAI, JPEGs declared as image/png to Gemini0 comments · 2026-11-16