File size: 3,117 Bytes
1e4e0a0
1b82aab
 
 
 
1e4e0a0
1b82aab
1e4e0a0
1b82aab
 
 
 
 
 
 
 
1e4e0a0
 
1b82aab
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
be373c6
1b82aab
 
 
 
 
be373c6
 
 
 
 
 
 
 
 
 
1b82aab
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
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`.