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.
pip install paperpush
To install the playwright dependency and the required browsers, run:
playwright install
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.
paperpush subfile VENUE
: creates a file VENUE.sub that is a template for the VENUE submission.fill out VENUE.sub - 3 options:a. fill out manuallyb.*** 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.
paperpush validate VENUE.sub
: run the pre-submission checks on the filledVENUE.sub
.paperpush login VENUE
: log in to the VENUE submission portalpaperpush 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.
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.
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
See CONTRIBUTING.md for instructions on adding new venues. See
for tips on adding new venues and running unit tests.
DEVELOPMENT.md
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.This project is licensed under the BSD-2 License - see the LICENSE file for details.
Developed by Joe Rich