Hugging Face Release Checklist (AICE-v1)

1) Pre-flight

Verify local package folder: AICE_PUBLIC
Verify required files exist:
- README.md
- EU_TRAINING_SUMMARY.md
- config.json
- generation_config.json
- tokenizer.json
- tokenizer_config.json
- special_tokens_map.json
- model.safetensors
- mobile/AICE_v1_int8.onnx + .data
- mobile/AICE_v1_q4.onnx + .data
- mobile/AICE_v1_rwkv4_custom.gguf
Verify LFS rules: AICE_PUBLIC/.gitattributes
Generate/refresh integrity manifest: AICE_PUBLIC/RELEASE_MANIFEST_SHA256.txt

2) Optional smoke tests

HF/Transformers load test from AICE_PUBLIC
ONNX Runtime test for INT8/Q4
gguf-dump mobile/AICE_v1_rwkv4_custom.gguf

3) Auth

Login once:
- huggingface-cli login
Or export token:
- set HF_TOKEN=hf_xxx (Windows)
Or use .env in project root:
- HF_TOKEN=...
- HF_REPO_ID=RthItalia/AICE-v1

4) Upload (recommended script)

python scripts/hf_upload_public.py `
  --repo-id <username-or-org>/AICE-v1 `
  --local-dir AICE_PUBLIC `
  --commit-message "Release AICE-v1"

For first private draft:

python scripts/hf_upload_public.py `
  --repo-id <username-or-org>/AICE-v1 `
  --local-dir AICE_PUBLIC `
  --private `
  --commit-message "Draft release AICE-v1"

5) Post-upload checks

Open model page and verify files rendered correctly.
Verify model card sections and compliance file visibility.
Confirm large files are tracked with LFS (Hub shows LFS pointer and size).
Pin release tag/commit in internal changelog.