hybridherbst commited on
Commit
fd3cc3c
·
verified ·
1 Parent(s): c24db76

Update model card

Browse files
Files changed (1) hide show
  1. README.md +13 -70
README.md CHANGED
@@ -12,24 +12,22 @@ tags:
12
  - apple-amlr
13
  ---
14
 
15
- # ml-sharp-webgpu
16
 
17
- This repository contains a browser-oriented ONNX/WebGPU export of Apple's SHARP
18
- monocular view-synthesis model. It is a derived artifact of the official
19
- [`apple/Sharp`](https://huggingface.co/apple/Sharp) checkpoint, packaged for the
20
- `sharp_webgpu.html` browser runtime in
21
- [`apple/ml-sharp`](https://github.com/apple/ml-sharp).
22
 
23
  This is not the official Apple checkpoint repository and is not endorsed by
24
- Apple. The goal of this repo is to make the released research model easier to
25
- run in WebGPU-capable browsers through the SHARP WebGPU pipeline and
26
- Transformers.js v4.
27
 
28
  ## Intended Use
29
 
30
  - Non-commercial scientific research and academic development.
31
- - Browser-side WebGPU inference for SHARP image-to-splat and panorama workflows.
32
- - Local validation of the staged ONNX export against the SHARP WebGPU runtime.
 
33
 
34
  ## Not Intended For
35
 
@@ -48,7 +46,7 @@ That license limits use, modification, derivatives, and redistribution to
48
  research purposes and excludes commercial exploitation, product development, or
49
  commercial product/service use.
50
 
51
- This ONNX/WebGPU bundle is a derived artifact from the released SHARP model and
52
  should be treated as a model derivative for licensing purposes.
53
 
54
  Attribution required by `LICENSE_MODEL`:
@@ -56,65 +54,10 @@ Attribution required by `LICENSE_MODEL`:
56
  > Apple Machine Learning Research Model is licensed under the Apple Machine
57
  > Learning Research Model License Agreement.
58
 
59
- Modifications from the upstream `apple/Sharp` release:
60
-
61
- - Exported the PyTorch checkpoint to a staged ONNX layout for browser execution.
62
- - Split execution into `stage-1` through `stage-4` for ONNX Runtime WebGPU.
63
- - Applied the ONNX Runtime 1.26 compatibility export/patch that removes
64
- `Cast(to=DOUBLE) -> IsInf` adapters emitted by PyTorch `nan_to_num`.
65
- - Added a `manifest.json` consumed by the SHARP WebGPU runtime.
66
-
67
- ## Files
68
-
69
- ```text
70
- README.md
71
- LICENSE
72
- LICENSE_MODEL
73
- .gitattributes
74
- config.json
75
- manifest.json
76
- sharp_stage_1.onnx
77
- sharp_stage_1.onnx.data
78
- sharp_stage_2.onnx
79
- sharp_stage_3.onnx
80
- sharp_stage_4.onnx
81
- SHA256SUMS
82
- ```
83
-
84
- ## Browser Usage
85
-
86
- Serve the SHARP WebGPU app and load this repository through Transformers.js:
87
-
88
- ```text
89
- http://localhost:8000/sharp_webgpu.html?model=ml-sharp-webgpu
90
- ```
91
-
92
- For local validation before upload, place this folder under `webgpu/models/` and
93
- open:
94
-
95
- ```text
96
- http://localhost:8000/sharp_webgpu.html?model=ml-sharp-webgpu&local=1&localModelPath=./models/
97
- ```
98
-
99
- ## Validation
100
-
101
- This folder was prepared with:
102
-
103
- ```bash
104
- ./.venv/bin/python webgpu/prepare_hf_release.py --repo-id ml-sharp-webgpu
105
- ```
106
-
107
- Before publishing, run:
108
-
109
- ```bash
110
- ./.venv/bin/python webgpu/prepare_hf_release.py \
111
- --repo-id ml-sharp-webgpu \
112
- --validate-only
113
- ```
114
 
115
- The validation checks that all expected files are present, external ONNX data is
116
- available, SHA-256 hashes match, license markers exist in this model card, and
117
- `sharp_stage_1.onnx` no longer contains the ORT 1.26 double-cast export pattern.
118
 
119
  ## Citation
120
 
 
12
  - apple-amlr
13
  ---
14
 
15
+ # Sharp-webgpu
16
 
17
+ This repository contains a staged ONNX export of Apple's SHARP monocular
18
+ view-synthesis model. It is a derived artifact of the official
19
+ [`apple/Sharp`](https://huggingface.co/apple/Sharp) checkpoint.
 
 
20
 
21
  This is not the official Apple checkpoint repository and is not endorsed by
22
+ Apple. The package contains model graph files, external tensor data, checksums,
23
+ licenses, and a manifest describing the staged artifact layout.
 
24
 
25
  ## Intended Use
26
 
27
  - Non-commercial scientific research and academic development.
28
+ - Evaluation of a staged ONNX derivative of the released SHARP research model.
29
+ - Integration into research clients that implement the required SHARP
30
+ preprocessing, staged inference, and postprocessing steps.
31
 
32
  ## Not Intended For
33
 
 
46
  research purposes and excludes commercial exploitation, product development, or
47
  commercial product/service use.
48
 
49
+ This ONNX artifact bundle is a derived artifact from the released SHARP model and
50
  should be treated as a model derivative for licensing purposes.
51
 
52
  Attribution required by `LICENSE_MODEL`:
 
54
  > Apple Machine Learning Research Model is licensed under the Apple Machine
55
  > Learning Research Model License Agreement.
56
 
57
+ Artifact modifications from the upstream `apple/Sharp` release:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
58
 
59
+ - Exported the PyTorch checkpoint to a staged ONNX layout.
60
+ - Split execution into `stage-1` through `stage-4`.
 
61
 
62
  ## Citation
63