GitHub - pachterlab/paperpush · GitHub
/" data-turbo-transient="true" />
Skip to content
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
pachterlab
paperpush
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>75
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>26 Commits<br>26 Commits
.claude
.claude
.githooks
.githooks
.github/workflows
.github/workflows
.vscode
.vscode
docs
docs
paperpush
paperpush
scripts
scripts
tests
tests
.gitattributes
.gitattributes
.gitignore
.gitignore
.readthedocs.yaml
.readthedocs.yaml
AGENTS.md
AGENTS.md
CONTRIBUTING.md
CONTRIBUTING.md
DEVELOPMENT.md
DEVELOPMENT.md
FAQ.md
FAQ.md
LICENSE
LICENSE
README.md
README.md
pyproject.toml
pyproject.toml
venues.md
venues.md
View all files
Repository files navigation
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
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 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.
paperpush validate VENUE.sub: run the pre-submission checks on the filled VENUE.sub.
paperpush login VENUE: log in to the VENUE submission portal
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<br>AGENTS.md. It describes how to run the full pipeline while doing<br>your own field extraction (reading the manuscript and writing a<br>values.json for the default --engine manual) rather than relying on the<br>API-backed engine. Claude Code should prefer the /paperpush-prepare-submission<br>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
About<br>No description, website, or topics provided.<br>Resources<br>Readme<br>BSD-2-Clause license<br>Contributing<br>Contributing<br>Activity<br>Custom properties<br>Stars<br>75 stars<br>Watchers<br>4 watching<br>Forks<br>4 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.