# Instalación

**Preview 0.45** Disponible · Preview 0.45. La API puede cambiar antes de la 1.0: ver [Fases de lanzamiento](/docs/es/resources/release-phases/).

## Paquetes

| 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.

## El token del registro

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.

```ini
# .npmrc
@neurologyca:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}
```

## Instalar

```bash
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.

## Requisitos

- 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](/docs/es/start/devices-and-modes/).
- 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.

## Sin bundler

`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>
```
