workspace/docs/hf_sync.md

# Hugging Face Sync

Target repo: `anhtld/vla`.

One-shot push:

```bash
PATH="$PWD/.venv/bin:$PATH" HF_REPO_ID=anhtld/vla scripts/hf_push_once.sh
```

Continuous push every 15 minutes:

```bash
setsid env PATH="$PWD/.venv/bin:$PATH" \
  HF_REPO_ID=anhtld/vla \
  HF_REPO_TYPE=model \
  HF_SYNC_INTERVAL_SECONDS=900 \
  scripts/hf_push_every_15m.sh \
  >> outputs/hf_sync/hf_push_daemon_login.out 2>&1 < /dev/null &
echo $! > outputs/hf_sync/hf_push_daemon_login.pid
```

Stop the login-node daemon:

```bash
kill "$(cat outputs/hf_sync/hf_push_daemon_login.pid)"
```

Monitor:

```bash
tail -f outputs/hf_sync/hf_push_daemon_login.out
tail -f outputs/hf_sync/hf_sync.log
```

The sync excludes `.env`, token-like files, keys, `.git`, virtualenvs, containers,
and build caches. It includes code, `latex/`, results, logs, outputs, checkpoints,
selected scratch experiment roots, and cache roots configured in
`scripts/hf_push_once.sh`.