Skip to content

LilanOvO/Auto-Resubmit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Auto-Resubmit

Lossless LaTeX template migration for conference resubmission.

ACL EMNLP NeurIPS ICML ICLR CVPR ICCV AAAI

Mutual Conversion Across Supported Conference Families

Source Paper ZipAuto-Resubmit Lossless MigrationTarget Conference Template Zip

简体中文 · Support Matrix

Offline First Lossless Migration Supported Families

Overview 🧭

Auto-Resubmit converts a source LaTeX paper zip into a target conference template zip while keeping the manuscript content intact.

自动重投:支持 ACL、EMNLP、NeurIPS、NIPS、ICML、ICLR、CVPR、ICCV、AAAI 等会议家族之间的模板互转。给定“源论文 LaTeX 项目 zip”和“目标会议模板 zip”,工具会自动抽取论文主体内容,并按目标会议模板重新组装、编译和打包,尽量减少手工改模板的工作量。

It is designed for the common resubmission workflow:

  • read a source paper project zip
  • read a target template zip
  • detect the main manuscript entry
  • extract title, abstract, body, bibliography block, appendix, and required macros
  • rebuild the paper in the target template family
  • copy figures, .bib, and local assets
  • compile the converted project and package the result

Supported Families 🔁

Family Venue Names
ACL family acl, emnlp
NeurIPS family neurips, nips
ICML family icml
ICLR family iclr
CVPR family cvpr, iccv
AAAI family aaai

Details: SUPPORT_MATRIX.md

Current Scope ⚠️

Auto-Resubmit is still an early, rule-based version.

It already handles the main conversion workflow across the supported conference families, but it does not claim to cover every LaTeX convention used by every research paper. Some papers contain custom frontmatter logic, self-defined environments, special title-page layouts, unusual appendix entrypoints, or package interactions that are not yet covered by the current rules.

In practice, conversion is most likely to work well when:

  • the source is a standard LaTeX project zip
  • the source has one clear main entry file
  • figures, bibliography files, and local style files are all included
  • the paper mostly follows a standard conference template structure
  • custom macros are present, but do not completely redefine the document structure

You may still need to make manual fixes when:

  • the paper uses heavily customized frontmatter or title-page logic
  • abstract, appendix, or bibliography are injected through nonstandard wrappers
  • the source relies on custom build scripts or external assets
  • the source defines special commands or environments that the current rules do not infer correctly

The good news is that the main conversion scaffold is already there. If a case is close but not perfect, it is often fixable with a small rule update rather than a full rewrite.

If you run into one of these cases, you are very welcome to fork the repository and patch the rules for your own template or paper. Using tools like Codex or Claude Code is often enough to diagnose and fix these edge cases quickly.

Installation ⚙️

Requirements

  • Python 3.10+
  • pip
  • tectonic

Python Dependencies

Auto-Resubmit currently uses only the Python standard library.

  • Third-party Python packages: none
  • External tool required for PDF compilation: tectonic

python -m pip install --editable . installs the current repository itself and exposes the auto_resubmit command-line entrypoint.

Option A: conda

git clone https://github.com/LilanOvO/Auto-Resubmit.git
cd Auto-Resubmit

conda create -n auto-resubmit python=3.10 -y
conda activate auto-resubmit
python -m pip install --editable .

Option B: venv

python -m venv .venv
source .venv/bin/activate
python -m pip install --editable .

If you do not need editable mode, you can also use:

python -m pip install .

Install tectonic

Install tectonic separately. After installation, this command should work:

tectonic --version

Typical install options:

# conda
conda install -c conda-forge tectonic
# cargo
cargo install tectonic
# macOS
brew install tectonic

If tectonic is missing, the project can still generate the converted LaTeX project, but it will not produce the final PDF.

Verify the Installation

After pip install --editable ., at least one of the following should work:

auto_resubmit --help
python -m auto_resubmit --help

Quick Start 🚀

auto_resubmit run \
  --source-zip /path/to/source-paper.zip \
  --target-template-zip /path/to/target-template.zip \
  --output-dir /path/to/output-dir

If auto_resubmit is not found in your shell, use:

python -m auto_resubmit run \
  --source-zip /path/to/source-paper.zip \
  --target-template-zip /path/to/target-template.zip \
  --output-dir /path/to/output-dir

Output 📦

On success, the output directory contains:

  • converted_project.zip
  • converted_project/resubmitted.tex
  • converted_project/resubmitted.pdf
  • conversion_manifest.json
  • content_audit.json
  • converted_project/tectonic.log

Input Guidelines 📝

  • Source input should be a LaTeX project zip, not a PDF
  • Target input should be an official conference template zip
  • The source zip should contain one real manuscript entrypoint
  • Figures, .bib, and local .sty files should be included in the zip
  • Projects that depend on private shell scripts or missing external assets are out of scope

Troubleshooting 🩺

  • auto_resubmit: command not found Use python -m auto_resubmit --help first. If that works, your environment is fine and only the shell entrypoint is missing.
  • compiler: not_found tectonic is not installed or not on PATH.
  • pdf_path: not_generated The converted LaTeX project was generated, but PDF compilation failed. Check converted_project/tectonic.log.
  • first tectonic run is slow This is normal. tectonic may need to populate its local cache on first use.

Star History ⭐

Star History Chart

Roadmap 🛣️

This repository is still an early version of Auto-Resubmit.

The longer-term goal is to evolve it into a multi-agent system that can:

  • identify the reviewer feedback that is actually actionable
  • revise and improve a paper from the previous venue
  • migrate the final manuscript into the target conference template with cleaner automation

The author is also actively collecting more real conference templates and source-project cases in order to improve the rule set and make the converter more robust over time.

If this direction interests you, collaborations are welcome. If you would like to contribute and join as a contributor, feel free to contact me at zjuqww@gmail.com.

About

🚀 Automated & lossless LaTeX paper migration tool. Instantly convert your Overleaf source between top-tier AI conference templates (NeurIPS, ICLR, ACL等). 一键无损转换顶会论文格式!解决转投时的排版折磨,完美保留公式、图表与引用,让科研人员专注研究而非排版。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages