Skip to content

0.1.0

Choose a tag to compare

View all tags
@yuema137 yuema137 released this 08 Sep 15:51
· 7 commits to main since this release
0.1.0
1935998
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First tagged release of PairTeX.

PairTeX is a local, Git-native review layer for LaTeX projects you already have. It replaces the manual loop of compiling a PDF, reading it, and copying quotes and comments back into a chat window by hand: it renders your existing repository into an HTML view where you comment and edit in place, and records every action as a structured feedback file your coding agent reads directly.

Your repository stays canonical and read-only from PairTeX's perspective. The HTML projection and the feedback files are disposable companion artifacts.

What is in this release

  • Local review server (pairtex.py): HTML projection, comments, Edit and Review modes, formula editing, threads, feedback persistence under .pairtex/feedback/, section navigation, and Refresh. Picks the next free localhost port if the requested one is taken.
  • Renderer (pairtex_render.py) defaulting to make4ht, with --adapter-command for an external adapter. The adapter runs against a disposable project copy and never edits your source.
  • Agent protocol in skills/pairtex-agent/SKILL.md: feedback schema, anchor rules, lifecycle semantics, thread format, and the boundaries an agent must respect.
  • Public demos: a minimal demo/fixture, plus the same synthetic paper in ICLR, NeurIPS, and ICML wrappers.
  • English and Simplified Chinese READMEs.
  • MIT license.
  • pyproject.toml declaring the supported Python range (>=3.11) and an explicitly empty dependency list: PairTeX runs on the standard library alone.
  • uv-pinned development environment (.python-version, uv.lock) and a test suite covering the full human-agent loop, run with uv run python -m unittest discover -s tests -t ..
  • --version on both entry points, checked against pyproject.toml by a test so the tag and the tool cannot disagree.
  • CI on every push and pull request, running the tests across the whole declared Python range (3.11 through 3.14) plus a lockfile and version-consistency check, with Dependabot keeping the pinned actions current.

Try it

python3 pairtex.py \
  --project demo/fixture \
  --html demo/fixture/rendered.html \
  --port 8765

Scope

PairTeX is not an IDE or an Overleaf replacement. It does not provide a compiler, a source editor, a bibliography manager, an agent framework, an LLM integration, CRDT collaboration, or HTML-to-LaTeX rewriting.

Assets 2
Loading