Yosun commited on
Commit
078527f
·
verified ·
1 Parent(s): 5ad1cb0

Update TripoSplat WebGPU Space card (production)

Browse files
Files changed (1) hide show
  1. README.md +41 -5
README.md CHANGED
@@ -1,10 +1,46 @@
1
  ---
2
- title: TripoSplatWebGPU
3
- emoji: 🚀
4
- colorFrom: yellow
5
- colorTo: indigo
 
6
  sdk: static
7
  pinned: false
 
 
8
  ---
9
 
10
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: TripoSplat WebGPU
3
+ short_description: Image-to-3D Gaussian splats with local WebGPU or MutualGPU.
4
+ emoji: 🫧
5
+ colorFrom: blue
6
+ colorTo: purple
7
  sdk: static
8
  pinned: false
9
+ models:
10
+ - Yosun/TripoSplat-WebGPU
11
  ---
12
 
13
+ # TripoSplat WebGPU
14
+
15
+ Generate a 3D Gaussian splat from one image using either qualified browser-local WebGPU or community-contributed MutualGPU compute. Both modes return to the same interactive preview and export binary PLY plus browser `.splat` files. Qualified devices can also opt in as MutualGPU providers. Hugging Face hosts this static app and the model artifacts; it does not provide inference compute.
16
+
17
+ ## Before you run
18
+
19
+ - **Local mode:** use a qualified WebGPU browser and allow roughly 6.47 GB for the first verified model download and browser cache. The recorded qualification environment is Chrome 150 on an Apple M3 Max with 128 GB unified memory; Edge and 16 GB devices are not yet qualified.
20
+ - **MutualGPU mode:** the public `https://mutualgpu.com/` exchange is selected by default, so you can choose an image and proceed immediately. It does not require local WebGPU or model storage, but it uploads the selected image to the exchange and assigned community provider.
21
+ - **Contribute mode:** a device that passes local preflight can enter an operator-issued provider key, advertise an honest machine profile, and process one assignment at a time. The key remains only in page memory.
22
+ - Choose PNG, WebP, JPEG, or AVIF. Local opaque-image preparation downloads and caches a separate browser model on first use. MutualGPU submissions are normalized to a supported format and a maximum 1024-pixel edge.
23
+ - The standard run requests 20 sampling steps / 40 CFG DiT calls. This remains an engineering execution path, not a numerical-parity or production-readiness claim.
24
+
25
+ For local execution, the app downloads versioned model artifacts directly from [Yosun/TripoSplat-WebGPU](https://huggingface.co/Yosun/TripoSplat-WebGPU), verifies their declared size and SHA-256, and caches them in browser storage when permitted. Local mode keeps source-image inference on the device. MutualGPU generation sends the image to the configured exchange and assigned provider; provider mode receives untrusted requestor images. Deployment analytics, CDN logs, browser extensions, and image URL hosts remain separate privacy considerations.
26
+
27
+ > **Engineering preview:** the four-step prepared-image path has a structural/export/viewer pass but misses a stricter diagnostic. Whole-scene numerical/render parity, repeated-run memory behavior, Edge, and 16 GB devices are not yet qualified.
28
+
29
+ [Source, status, benchmarks, and issue tracker](https://github.com/ai3d-dev/TripoSplatWebGPU) · [Vercel mirror](https://triposplat-webgpu.vercel.app/e2e-web)
30
+
31
+ ## Deploy this card and the prebuilt app
32
+
33
+ This is the production Space card for [`Yosun/TripoSplatWebGPU`](https://huggingface.co/spaces/Yosun/TripoSplatWebGPU). The staging/test deployment lives at [`Yosun/TripoSplat-WebGPU-Demo`](https://huggingface.co/spaces/Yosun/TripoSplat-WebGPU-Demo) and uses `huggingface-space/README.demo.md`.
34
+
35
+ Deploy from the repository root with the tracked script, which builds, runs `pnpm verify:web-runner`, and uploads the prebuilt bundle plus this card:
36
+
37
+ ```bash
38
+ corepack enable
39
+ pnpm install --frozen-lockfile
40
+ DEPLOY_ENV=production node scripts/deploy.mjs --hf-only # production → Yosun/TripoSplatWebGPU
41
+ DEPLOY_ENV=staging node scripts/deploy.mjs --hf-only --test # staging → Yosun/TripoSplat-WebGPU-Demo
42
+ ```
43
+
44
+ Both origins share the same model manifest namespace and CDN base, so redeploying either Space does not re-download files already cached in a visitor's browser. Only the first visit to each distinct Space origin downloads the model, because browser OPFS/Cache storage is origin-isolated.
45
+
46
+ The root `dist/index.html` is already built; this card intentionally uses only `sdk: static` and does not request Hugging Face compute or a custom build command. Hugging Face may still require plan credits to activate updated Static Space hosting.