paperpush 0.1.0

A Python library for automating the submission of manuscripts to academic venues.

PaperPush: Automated manuscript submission to journals, conferences, and preprint servers

Prepare manuscripts for submission to preprint servers, venues, and conferences with just a few commands. No need to spend hours filling out forms manually. Just provide a manuscript directory and submission venue of interest, and paperpush will fill out the submission portal for you.

Install

pip install paperpush

To install the playwright dependency and the required browsers, run:

playwright install

Use with AI

Prepare my manuscript in /PATH/TO/MANUSCRIPT/DIRECTORY for submission to VENUE with PaperPush.

The Claude skill /paperpush-prepare-submission helps with this.

See docs/example-session.md for a full worked example of this flow.

Quickstart

1. paperpush subfile VENUE: creates a file VENUE.sub that is a template for the VENUE submission.
2. fill out VENUE.sub - 3 options:
   • a. fill out manually
   • b. Ask an LLM: Use Claude skill /paperpush-autofill, or any AI agent following AGENTS.md.
   • c. paperpush autofill -d /PATH/TO/MANUSCRIPT/DIRECTORY --engine api VENUE.sub: Use an LLM API. Requires an API key.
3. paperpush validate VENUE.sub: run the pre-submission checks on the filled VENUE.sub.
4. paperpush login VENUE: log in to the VENUE submission portal
5. paperpush submit VENUE.sub: Fill out the VENUE submission portal. Will not actually submit the manuscript. We highly recommend reviewing the submission form in the venue portal before clicking submit.

Run the whole pipeline at once

scripts/paperpush_pipeline.py sequentially runs the commands above — subfile, autofill, validate, login, submit. This allows going from a manuscript directory to a filled submission portal in just one command.

python scripts/paperpush_pipeline.py -d /PATH/TO/MANUSCRIPT/DIRECTORY --engine api VENUE

See python scripts/paperpush_pipeline.py --help for the full list of options, grouped by step.

Supported venues

Preprint servers: arXiv, bioRxiv, medRxiv

Journals: Bioinformatics, BMC Bioinformatics, Cell, Cell Genomics, Cell Systems, Discrete Mathematics, Genome Biology, Nature, Nature Biotechnology, Nature Methods, Nucleic Acids Research, PLOS Computational Biology, Science, Science Advances, Science Immunology, Science Robotics, Science Signaling, Science Translational Medicine

Conferences: none yet

View the list on the command line with paperpush --venues.

For more details, see venues.md

Documentation

paperpush.readthedocs.io

Adding new venues

See CONTRIBUTING.md for instructions on adding new venues. See DEVELOPMENT.md for tips on adding new venues and running unit tests.

For AI agents

If you are an AI agent asked to submit a manuscript on the user's behalf, read AGENTS.md. It describes how to run the full pipeline while doing your own field extraction (reading the manuscript and writing a values.json for the default --engine manual) rather than relying on the API-backed engine. Claude Code should prefer the /paperpush-prepare-submission and /paperpush-autofill skills, which encode the same contract.

License

This project is licensed under the BSD-2 License - see the LICENSE file for details.

Developed by Joe Rich