--- 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](https://huggingface.co/depth-anything/Depth-Anything-V2-Small) vía la conversión ONNX [onnx-community/depth-anything-v2-small](https://huggingface.co/onnx-community/depth-anything-v2-small) y [Transformers.js](https://huggingface.co/docs/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 ```bash 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): ```bash npm run smoke ``` Empaquetar ZIP desplegable (raíz = `index.html` + `README.md` + `BROWSER_CHECKLIST.md`): ```bash npm run build && npm run package:zip ``` Verificación local del comparador (Chromium, sin modelo / sin HF): ```bash 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`.