# 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

```powershell
.\.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`):

```powershell
.\.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:

```markdown
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) |