papers/SUBMISSION.md

Submitting Arriella manuscripts to arXiv and Hugging Face Papers

Why not Spaces or model repos?

• Spaces = runnable apps / demos.
• Models = weight checkpoints + model cards.
• Papers on Hugging Face = pages indexed from arXiv (https://huggingface.co/papers/<arxiv-id>).

There is no supported “upload a PDF as a Paper Page without arXiv” path.

Step 1 — Package sources

.\.venv\Scripts\python.exe scripts\package_arxiv.py

Creates docs/arxiv/submission-packages/<manuscript>.zip containing paper.tex (+ abstract.txt).

Step 2 — Submit on arXiv

1. Log in at https://arxiv.org/submit
2. For each manuscript, use categories from that folder’s metadata.yaml
3. Upload the corresponding zip (Process with TeX)
4. Paste abstract.txt into the abstract field
5. Complete license / metadata and submit

Suggested order: 01-fleet-factory → 02-grapevine → 03-eat-system → 05-evaluation → shorter companions (04, 06, 07).

Step 3 — Index on Hugging Face Papers

After the paper is announced (ID like 2607.01234):

.\.venv\Scripts\python.exe scripts\index_hf_papers.py --arxiv-id 2607.01234 --manuscript 01-fleet-factory

Or open https://huggingface.co/papers/2607.01234 once to trigger indexing.

Then:

1. Open the paper page → claim authorship if listed
2. On future model repos, add the arXiv URL in the model card README so HF auto-tags arxiv:<id>
3. Optionally show the paper on your HF profile (Settings → Papers)

Step 4 — Link models (when weights are published)

Model cards should cite papers like:

Paper: https://arxiv.org/abs/YYYY.NNNNN
HF Papers: https://huggingface.co/papers/YYYY.NNNNN

Do not create model repos that contain only paper markdown.

Local SoT

Path	Role
docs/arxiv/*/paper.md	Editable manuscript source
docs/arxiv/submission-packages/	Generated LaTeX zips
docs/archive/2026-07/	Historical only
docs/papers/	Product whitepaper / drafts (not HF Paper Pages)