Guías de Zovo

Ver tensores de NumPy, PyTorch y GGUF en VS Code

Instala Tensor Viewer y haz clic en un archivo .npy, .npz, .pt, .pth, .ckpt, .safetensors o .gguf. VS Code lista cada tensor con su nombre, tipo y forma, sin ejecutar Python. Las estadísticas, el mapa de calor, la tabla de valores, las imágenes y guardar como .npy o CSV son gratis. Zovo Pro (USD 19 una sola vez) añade la comparación de dos checkpoints y un análisis completo de NaN, Inf y ceros, con 3 usos gratis de cada herramienta.

Instalar en VS CodePágina del MarketplaceOpen VSX (Cursor, Windsurf, VSCodium)

Gratis, licencia MIT. Extension ID zovo.tensor-viewer.

Pasos en VS Code

  1. Instala Tensor Viewer desde el Marketplace, o pulsa Ctrl+P (Cmd+P en macOS) y ejecuta ext install zovo.tensor-viewer.
  2. Haz clic en el archivo en el Explorador. Verás una tabla con el nombre, el tipo, la forma, el número de parámetros, el tamaño y el offset de cada tensor, con un cuadro de filtro. Arriba aparecen el total de parámetros, el número de tensores y el tamaño del archivo; en GGUF, también la arquitectura, la longitud de contexto, las capas y el tipo de archivo.
  3. Haz clic en un tensor para ver el mínimo, el máximo, la media, la desviación típica y el número de NaN, +Inf, -Inf y ceros, junto con un mapa de calor (2D), un gráfico de línea (1D) y un histograma.
  4. En la tabla de valores, pasa de página o escribe un corte como [5, :, :]. Con “Copy values” copias los valores como texto separado por tabuladores.
  5. Si el tensor tiene forma de imagen, como (H, W, 3) o (N, 3, H, W), se dibuja como imagen; elige la disposición, el fotograma y el rango de valores.
  6. Para guardar un tensor o un corte, usa “Save as .npy...” o “Save as CSV...”. Para un volcado binario sin cabecera, como los de ndarray.tofile(), haz clic derecho y elige “Open as Raw Array...”.

En Cursor, Windsurf y VSCodium

Estos editores instalan extensiones desde Open VSX. Abre la vista Extensions (Ctrl+Shift+X), busca zovo.tensor-viewer y pulsa Install. Su página en Open VSX es zovo/tensor-viewer. Después se usa igual que en VS Code.

Qué es gratis

Es gratis abrir NumPy .npy y .npz, safetensors, GGUF y archivos de PyTorch (.pt, .pth, .ckpt, pytorch_model.bin): state dicts, checkpoints completos de entrenamiento, archivos .ckpt de Lightning, modelos guardados enteros, TorchScript y el formato anterior a PyTorch 1.6. En GGUF se decodifican Q8_0, Q4_0, Q4_1, Q5_0, Q5_1, Q4_K, Q5_K y Q6_K para las estadísticas y los mapas de calor. Los archivos grandes se abren rápido porque primero solo se lee la cabecera y después los bytes del tensor que eliges; en la prueba del autor, un safetensors de 10,7 GB se abrió en menos de un segundo. El pickle de PyTorch se lee sin ejecutarlo: los nombres de Python desconocidos se listan con una valoración de seguridad, y un archivo que ejecutaría os.system o eval muestra un aviso en rojo. La vista se recarga sola cuando el archivo cambia (tensorViewer.autoReload). No tiene telemetría.

Qué añade Zovo Pro

“Compare Two Tensor Files (Checkpoint Diff)” lee todos los valores de dos archivos, por ejemplo dos pasos de entrenamiento o un modelo antes y después de convertirlo, y da para cada tensor la diferencia absoluta máxima y media, el RMSE, el error L2 relativo, la similitud coseno, cuántos valores difieren y dónde está el mayor cambio. También lista los tensores que solo existen en uno de los archivos y los cambios de forma o de tipo. Funciona entre formatos distintos, como .safetensors frente a .pt, y con GGUF cuantizado, así que no tienes que escribir un script de comparación. El informe se puede filtrar y guardar como CSV, Markdown o JSON. La otra herramienta Pro, “Scan All Tensors for NaN, Inf and Zeros”, lee cada valor sin muestreo y marca NaN, Inf, tensores con todo ceros o constantes y valores de 10.000 o más.

Cómo se usa Compare Two Tensor Files (Checkpoint Diff)

  1. Selecciona dos archivos en el Explorador, haz clic derecho y elige “Zovo Pro: Compare Two Checkpoints”. También puedes pulsar “Compare with...” en la parte superior del visor o ejecutar “NumPy Viewer Pro: Compare Two Tensor Files (Checkpoint Diff)” desde la paleta de comandos.
  2. Filtra el informe y guárdalo como CSV, Markdown o JSON. Una comparación larga se puede cancelar.

Compare Two Tensor Files (Checkpoint Diff) funciona 3 veces gratis antes de pedir una licencia. Al abrir un archivo no aparece ninguna ventana emergente ni cuenta atrás.

Pagar con tarjeta, USD 19 una vez

Zovo Pro cuesta USD 19 en un solo pago. No es una suscripción y activa las herramientas Pro en todas las extensiones de Zovo. Después de pagar con tarjeta (Stripe), la clave de licencia aparece en la página siguiente. En VS Code, ejecuta "Enter Zovo Pro license key" desde la Command Palette y pega la clave. La clave se comprueba en tu equipo, sin conexión a la red.

Un equipo de 5 personas paga USD 59 en un solo pago, también con tarjeta. Todas las reglas y herramientas Pro están en la página de Zovo Pro (en inglés).

Lo que no hace

Preguntas

¿Es gratis?

Sí. Todos los formatos, la tabla de valores, las imágenes y guardar como .npy o CSV son gratis, y todo lo que era gratis antes de la versión 0.6.0 lo sigue siendo. Solo la comparación de checkpoints y el análisis de todos los tensores son herramientas de Zovo Pro, con 3 usos gratis cada una.

¿Funciona en Cursor?

Sí. Cursor instala las extensiones desde Open VSX. Busca zovo.tensor-viewer en la vista de extensiones.

¿Es seguro abrir un .pth descargado?

Tensor Viewer nunca ejecuta el pickle. Solo reconstruye tensores, dtypes y contenedores simples; cualquier otro nombre de Python se muestra como dato, con una valoración de seguridad. Además, te indica si torch.load(weights_only=True) debería aceptar el archivo.

¿Necesito Python?

No. Tensor Viewer lee los archivos por sí mismo, sin Python.

Todas las funciones y ajustes están en la página de Tensor Viewer (en inglés).

Comprobado con la versión 0.6.5 de la extensión el 2026-11-12.