Skip to content

Template Guide

Raghav Kattel edited this page Jun 1, 2026 · 1 revision

Template Guide

Venue templates are LaTeX style files that format papers for specific conferences and journals. Sisyphus Academica supports 5 venues, but all template directories are currently stubs — contributions are welcome.

Current Venues

Venue Path Status
NeurIPS templates/neurips/ 🟢 Template stub
ICML templates/icml/ 🟢 Template stub
ICLR templates/iclr/ 🟢 Template stub
Nature templates/nature/ 🟢 Template stub
arXiv templates/arxiv/ 🟢 Template stub

How to Add a Template

Step 1: Create the Directory

templates/<venue>/
├── <venue>.sty          # Style file (required)
├── <venue>.cls          # Class file (if applicable)
├── sample.tex           # Minimal working example (required)
├── references.bib       # Sample bibliography
└── figures/             # Sample figures (if applicable)

Step 2: Download Official Files

Get the official template from the venue's website or Overleaf:

Step 3: Add a Sample Paper

Create sample.tex that:

  • Uses the template style
  • Includes a title, author, abstract, sections, figures, bibliography
  • Compiles without errors

Step 4: Test Compilation

# Using Docker
docker compose --profile latex run latex pdflatex templates/<venue>/sample.tex
docker compose --profile latex run latex bibtex templates/<venue>/sample
docker compose --profile latex run latex pdflatex templates/<venue>/sample.tex
docker compose --profile latex run latex pdflatex templates/<venue>/sample.tex

Step 5: Register in the Formatter

Edit subagents/formatter.md to add the new venue:

- **<Venue>**: `templates/<venue>/<file>.cls` + `<file>.tex`

Step 6: Register in agent-config.json

Add the agent entry:

"formatter-<venue>": {
  "model": "9router/opencode-free",
  "variant": "fast",
  "description": "Formats papers for <Venue> submission",
  ...
}

Template Requirements

Each template directory should include:

File Required Purpose
<venue>.sty Yes LaTeX style file
<venue>.cls No LaTeX class file (alternative to .sty)
sample.tex Yes Working example showing all features
references.bib Recommended Sample bibliography entries
figures/ Recommended Sample figures at correct dimensions
README.md Recommended Notes on template version, quirks, known issues

Testing Checklist

  • pdflatex sample.tex compiles without errors
  • bibtex sample runs successfully
  • Two-pass pdflatex resolves all references
  • Output matches venue page limits
  • Figures render at correct resolution
  • Fonts match venue requirements

Clone this wiki locally