depth-lab / README.md
Segizu's picture
Fix comparator hidden measurement regression
be373c6 verified
|
Raw History Blame Contribute Delete
3.12 kB
metadata
title: DepthLab
emoji: 🧭
colorFrom: green
colorTo: yellow
sdk: static
app_file: index.html
pinned: false
license: apache-2.0
short_description: Profundidad relativa monocular en el navegador (WASM)
tags:
  - depth-estimation
  - transformers.js
  - onnx
  - wasm
  - spanish

DepthLab

Space estático (HTML/JS) para estimar profundidad relativa monocular en el navegador con Depth Anything V2 Small vía la conversión ONNX onnx-community/depth-anything-v2-small y Transformers.js 3.7.6.

Qué hace

  1. Cargas el modelo (~27 MB cuantizado) con barra de progreso.
  2. Eliges uno de 3 ejemplos CC0 o subes JPG/PNG/WebP.
  3. La inferencia corre en un Web Worker con WASM/CPU (no requiere WebGPU).
  4. Comparas original ↔ mapa coloreado, activas parallax artístico opcional y descargas PNG + JSON.

Límites honestos

  • Profundidad relativa / inversa: valores más altos ≈ más cerca. No son metros.
  • Normalización por imagen: no compares métricamente dos fotos.
  • No es medición, navegación, uso clínico ni reconstrucción 3D fiel.
  • Parallax = efecto artístico; agujeros por oclusión esperados.
  • Entrada: máx. 10 MB / 20 MP; lado largo de inferencia ≤1024 (el procesador DPT usa ~518, múltiplo de 14).

Privacidad

  • Las fotos no se suben a ningún servidor de la app: se decodifican con File / Object URLs locales.
  • La descarga del modelo/runtime desde Hugging Face sí genera metadatos de red habituales (IP/UA). Eso no es telemetría de tus imágenes.

Pins verificados

Campo Valor
Modelo onnx-community/depth-anything-v2-small
Revisión 4472b7362082ad9968fee890ca0f1e5aca36b93d
Pesos onnx/model_quantized.onnx (27 258 801 B)
SHA-256 fcf51f1b230362b28690bb9d1809bf0431f29cad20534e3f589bd7285547f20d
Librería @huggingface/transformers@3.7.6
Licencia modelo Apache-2.0

Desarrollo local

npm ci
npm test
npm run build
npm run dev   # http://127.0.0.1:43123

Smoke opcional en Node (no sustituye la prueba en el navegador del Space):

npm run smoke

Empaquetar ZIP desplegable (raíz = index.html + README.md + BROWSER_CHECKLIST.md):

npm run build && npm run package:zip

Verificación local del comparador (Chromium, sin modelo / sin HF):

npm run build && npm run verify:comparator

Nota de corrección (comparador)

Bug en vivo: el original se medía con #results[hidden] → clientHeight=0 → estilos inline 0×0 → el overlay vacío dejaba ver solo el mapa de profundidad a ambos lados del slider. La medición ocurre ahora después de mostrar resultados, con helper que no hornea ceros.

Ejemplos CC0

Ver examples/ATTRIBUTION.json (Storylanding, Jolene Hardy, Daderot — Wikimedia Commons).

Licencias

Apache-2.0 para el código de la app y el modelo. Avisos de terceros en NOTICE.