Ir al contenido
DevLab

Instalación

Instala @neurologyca/capture 0.45.0 y @neurologyca/capture-server 0.20.1 desde el registro privado de Neurologyca.

En esta página
  1. Paquetes
  2. El token del registro
  3. Instalar
  4. Requisitos
  5. Sin bundler

Preview 0.45 Disponible · Preview 0.45. La API puede cambiar antes de la 1.0: ver Fases de lanzamiento.

Paquete Versión Se ejecuta en Entradas Úsalo para
@neurologyca/capture 0.45.0 El navegador ., /record, /replay, /helpers El cliente en vivo (createProtocolClient), el cliente de grabación (/record), las ayudas (/helpers)
@neurologyca/capture-server 0.20.1 Tu backend (Node.js 20.3 o posterior) ., /node El proxy, el token, createEngineAdmin, el receptor de subidas y el cliente de procesado; /node los adapta a node:http

El paquete del navegador instala como dependencia @neurologyca/kodec 5.0.0-rc.14, el códec en el dispositivo. /replay es lo que ejecuta el servicio de procesado de Neurologyca; alojarlo tú mismo llegará más adelante.

Los dos paquetes juntos son lo que la doc llama el SDK: uno corre en el navegador y el otro en tu backend.

Los paquetes viven en el registro privado de GitHub Packages de Neurologyca. Instalarlos requiere un token de lectura en NODE_AUTH_TOKEN: lo entrega Neurologyca con tu invitación, por el mismo canal que la key; no está en DevLab. No es tu API key: no las confundas y mantén ambas fuera de git.

.env
# .npmrc
@neurologyca:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
Shell
export NODE_AUTH_TOKEN="<token del registro>"
npm install @neurologyca/capture@0.45.0
npm install @neurologyca/capture-server@0.20.1

En CI, define NODE_AUTH_TOKEN como secreto: actions/setup-node y npm lo leen tal cual.

  • Navegadores: Chrome o Edge 94+, Safari 16.4+ (iOS 16.4+). Firefox no es objetivo: kodec no se ha probado allí (en el dispositivo), y no graba MP4/H.264 (en diferido).
  • Sirve la página por HTTPS, o localhost mientras desarrollas: los navegadores solo abren la cámara en un contexto seguro. Nunca desde file://.
  • Qué depende del dispositivo (GPU, WebGPU para la voz) y cómo comprobarlo en ejecución: Dispositivos, calidad y modo.
  • Node.js 20.3 o posterior para @neurologyca/capture-server (los starters de tu kit piden 20.6, por node --env-file). Solo se ejecuta en el servidor: importado en un bundle del navegador, lanza un error al cargar la página.

dist/capture.global.js pone la API del paquete en window.NeuroCapture y no registra nada más. Cópialo a tu propio origen y sírvelo: no hay CDN público.

HTML
<script src="/capture.global.js"></script>