Hiro-Layout / OPEN_SOURCE_CHECKLIST.md
GradientDescentMe's picture
Initial open-source release
fc08c11 verified
# Open Source Release Checklist
Use this checklist before publishing Hiro-Layout to Hugging Face or GitHub.
## Repository Metadata
- [ ] Confirm final public model name and repo id, for example `PatSnap/Hiro-Layout`.
- [ ] Confirm model task and Hugging Face `pipeline_tag`.
- [ ] Confirm model architecture, parameter count, input resolution, and output schema.
- [ ] Confirm whether the release includes weights, inference code, configs, examples, and evaluation assets.
- [ ] Confirm whether `layout_model/RT-DETR_25.onnx` is the final public model artifact.
- [ ] Confirm all large binary files are tracked with Git LFS.
## Legal and License
- [ ] Confirm Apache-2.0 is approved for this model and code release.
- [ ] Confirm model weights can be released under the same license or document a separate model license.
- [ ] Confirm training data, evaluation data, and benchmark summaries are cleared for public disclosure.
- [ ] Confirm the Excel benchmark file can be publicly shared.
- [ ] Review `NOTICE` for trademark language.
- [ ] Review `DISCLAIMER.md` for product, legal, and compliance requirements.
## Model Card
- [ ] Replace the minimal ONNXRuntime inspection snippet with the final working inference API.
- [ ] Add installation instructions.
- [ ] Add hardware and runtime requirements.
- [ ] Add preprocessing details for PDF rendering and image normalization.
- [ ] Add output schema, including bounding box format and confidence score semantics.
- [ ] Confirm `labels.json` matches the class-id order used by `layout_model/RT-DETR_25.onnx`.
- [ ] Add example image and example prediction if public samples are available.
- [ ] Confirm benchmark numbers in `README.md`, `README_zh.md`, and `EVALUATION.md`.
## Release Assets
- [ ] Add model weights, config, tokenizer/processor files, and custom code if needed.
- [ ] Add `requirements.txt`, `pyproject.toml`, or environment instructions.
- [ ] Add minimal smoke-test script.
- [ ] Add citation metadata if there is a paper, blog, or technical report.
- [ ] Add a changelog or release notes.
## Final Validation
- [ ] Clone the public repo into a clean environment.
- [ ] Run the documented installation steps.
- [ ] Run the documented inference example.
- [ ] Verify README links render correctly on Hugging Face.
- [ ] Verify the license badge and model metadata render correctly on Hugging Face.