# Neurologyca DevLab > The documentation of Neurologyca Engine 2 and its capture SDK: human context for apps, agents and enterprise software, with real-time indicators of stress, engagement, cognitive load and more. Every page is also served as Markdown (`.md`); prefer these pages over what you remember. Agent skills: `npx skills add https://devlab.neurologyca.com` (or download them from https://devlab.neurologyca.com/docs/start/ai-agents/). Pages of one path in one file: [SDK (recommended)](https://devlab.neurologyca.com/docs/llms/sdk.txt), [Deferred (server-side) · Preview](https://devlab.neurologyca.com/docs/llms/deferred.txt), [HTTP API (complementary)](https://devlab.neurologyca.com/docs/llms/api.txt). ## Get started - [What is Engine 2](https://devlab.neurologyca.com/docs/start/what-is.md): The four components, what you integrate, what your organization can measure and what Engine returns. - [Integration paths](https://devlab.neurologyca.com/docs/start/paths.md): How you integrate (SDK and HTTP API) and where it is processed (on-device or deferred), with the measured numbers and a short guide to choose. - [Quickstart](https://devlab.neurologyca.com/docs/start/quickstart.md): From your API key to your first indicators: with the SDK in a page of yours, with cURL or with Python. - [Build with your coding agent](https://devlab.neurologyca.com/docs/start/ai-agents.md): Install the Neurologyca skills in your coding agent, paste the index into AGENTS.md and ask for the integration. It follows the verified steps of this documentation instead of guessing. - [Devices, quality and mode](https://devlab.neurologyca.com/docs/start/devices-and-modes.md): Which mode suits your people's devices, what depends on the device, how to check it before measuring and how to read the session rate after. - [Measurement only](https://devlab.neurologyca.com/docs/guides/measurement.md): Send capture data and get Human Context Indicators back, without interpretation. - [Install](https://devlab.neurologyca.com/docs/start/install.md): Install @neurologyca/capture 0.45.0 and @neurologyca/capture-server 0.20.1 from Neurologyca's private registry. - [Authentication](https://devlab.neurologyca.com/docs/start/authentication.md): Exchange your API key for a short-lived token, on your server. - [Your environments](https://devlab.neurologyca.com/docs/start/environments.md): Test and production are two environments with their own Engine URL, key and DevLab account. What is in each, and how to move. - [Test your integration](https://devlab.neurologyca.com/docs/start/testing.md): Test with deterministic data: your sandbox, a video of yours, synthetic frames for CI, the SDK under a fake camera, forced states and the webhook. ## SDK - [How the SDK works](https://devlab.neurologyca.com/docs/sdk.md): The two halves of the SDK, its two modes, what you decide and why the browser carries no token. - [On-device (real time)](https://devlab.neurologyca.com/docs/sdk/on-device.md): The live client: create it without a token, capture step by step, read the outcome, the warnings, the baseline, transcription and the event stream. - [Load the models](https://devlab.neurologyca.com/docs/guides/load-models.md): The five ways to load the face and speech models in the browser, which one to choose, what is downloaded and from where, and how to check it in your app. - [Steps and marking](https://devlab.neurologyca.com/docs/sdk/steps.md): How to drive each step without a component: its data, who closes it, the clock, the duration checks, the media you showed and the manifest of a recording. - [Results in your backend](https://devlab.neurologyca.com/docs/sdk/results-backend.md): How results arrive in each mode, SDK and API together, SSE or polling, the pair to keep, one-off queries and the signed webhook of the deferred mode. - [Your backend](https://devlab.neurologyca.com/docs/sdk/backend.md): The server half of the SDK: the proxy that adds the token, your session in front of it, createEngineAdmin, the upload receiver and key rotation. - [Errors, warnings and retries](https://devlab.neurologyca.com/docs/sdk/errors.md): Every error and warning of the SDK, by layer and by mode, what the SDK retries on its own, and what to send to support. - [SDK reference](https://devlab.neurologyca.com/docs/sdk/reference.md): Every export of @neurologyca/capture 0.45.0 and @neurologyca/capture-server 0.20.1, by entry, with its signature and the page that explains it. ## Deferred (server-side) · Preview - [Deferred (server-side)](https://devlab.neurologyca.com/docs/sdk/deferred.md): The recording client: record the video and a step manifest, upload them to your receiver, and follow the job of the processing service. - [Processing service](https://devlab.neurologyca.com/docs/sdk/processing.md): What our processing service does with a recording, what you expose to it, the token URL, the webhook, its error codes and Measurement in deferred. - [Timeouts](https://devlab.neurologyca.com/docs/guides/timeouts.md): How long the SDK, Engine and your proxy wait, and how to stack them so the right layer reports the problem. ## HTTP API - [HTTP API guide](https://devlab.neurologyca.com/docs/api.md): The HTTP API next to the SDK: one-off calls and your backend, and the full capture by HTTP for those who capture outside the browser. - [Proxy by hand](https://devlab.neurologyca.com/docs/api/proxy.md): The 13 routes the browser SDK calls, forwarded to Engine by a proxy of your own (Express or nginx), for when you do not use capture-server. - [API reference](https://devlab.neurologyca.com/docs/reference.md): Every Engine 2 route, generated from the public OpenAPI spec. ## Concepts - [Protocols and their hierarchy](https://devlab.neurologyca.com/docs/concepts/protocols.md): What Neurologyca publishes for your organization, what happens per person, and where microinterventions fit. - [Baseline](https://devlab.neurologyca.com/docs/concepts/baseline.md): A reference capture per person that calibrates every protocol. Engine recommends it, warns when it is missing, and never blocks without it. - [Capturing for the best accuracy](https://devlab.neurologyca.com/docs/concepts/capture.md): The conditions Engine and Capture actually check, what the first seconds of a capture lack, and the whitepaper's recommendations. - [Sessions, enrolments and interruptions](https://devlab.neurologyca.com/docs/concepts/sessions.md): How a capture is opened, closed, abandoned and restarted, how position clocks answer, and how microinterventions are offered. - [HCIs and results](https://devlab.neurologyca.com/docs/concepts/results.md): What a Human Context Indicator is, the shape of the results, the live events, and the interpretation for an audience. - [Show and use the results](https://devlab.neurologyca.com/docs/guides/show-results.md): What to show first when the indicators and the interpretation arrive, what arrives in each case, where the transcript is, what to keep and how to read again without paying. - [Responsible use](https://devlab.neurologyca.com/docs/guides/responsible-use.md): What the readings are never for, what your app takes on when it uses them, and what Neurologyca does on its side. - [Declared limits and failure modes](https://devlab.neurologyca.com/docs/concepts/limits.md): What Engine does not do, the technical limits, the mistakes that still answer 2xx, and the error bodies. ## Operate - [CSP and transcription](https://devlab.neurologyca.com/docs/guides/csp-transcription.md): The external origins Capture loads, a Content Security Policy that works with them, how to host them yourself, and how to set up transcription. - [Before production](https://devlab.neurologyca.com/docs/guides/production-checklist.md): A checklist per mode before you capture with real people in production. - [Your DevLab account](https://devlab.neurologyca.com/docs/access/account.md): Invitation, sign-in, sessions, revealing your team's key, and what DevLab records about you. - [Keys: rotation, revocation and expiry](https://devlab.neurologyca.com/docs/access/keys.md): What happens when your team's key changes, and what to do in your backend. - [Your kit](https://devlab.neurologyca.com/docs/access/kit.md): What the kit of a protocol contains, where to find it in DevLab, what every file and variable is, where your Engine URL is, and how to run a starter. - [Where everything is](https://devlab.neurologyca.com/docs/access/map.md): Every screen of DevLab for a developer and for an organization admin: where it is, what it has, what you can copy, and what you see when something is missing. - [Access model](https://devlab.neurologyca.com/docs/access/model.md): Organization, teams, keys and end users: what Engine isolates, and where DevLab adds its own limits. - [Pricing](https://devlab.neurologyca.com/docs/access/pricing.md): Pricing is coming soon: what Neurologyca costs, what you can use free of charge, and why integrating Neurologyca into an application needs a commercial agreement first. ## Resources - [For AI agents](https://devlab.neurologyca.com/docs/resources/agents.md): Plain-text versions of this documentation, the agent skills, the index and the sets for coding agents and LLMs. - [Known pitfalls](https://devlab.neurologyca.com/docs/resources/pitfalls.md): The integration traps we have measured, by path: the symptom you see, its cause and what to do. Generated from one source. - [Release phases](https://devlab.neurologyca.com/docs/resources/release-phases.md): What Preview and Coming soon mean, who can use each, what can change and where it is announced. - [SDK changelog](https://devlab.neurologyca.com/docs/resources/changelog.md): What each version of the SDK and capture-server brings, the breaking changes and the compatibility policy of the 0.x line. - [Privacy and data](https://devlab.neurologyca.com/docs/resources/privacy.md): What each mode does with the data, so you can write your consent and your record of processing: what leaves the device, retention layer by layer, what the SDK keeps in the browser, Engine and DevLab. - [Migrating from Engine 1.5](https://devlab.neurologyca.com/docs/resources/migration.md): What changes when you move an Engine 1.5 integration to Engine 2, route by route. ## Español - [Qué es Engine 2](https://devlab.neurologyca.com/docs/es/start/what-is.md): Los cuatro componentes, qué integras, qué puede medir tu organización y qué devuelve Engine. - [Vías de integración](https://devlab.neurologyca.com/docs/es/start/paths.md): Cómo integras (SDK y API HTTP) y dónde se procesa (en el dispositivo o en diferido), con las cifras medidas y una guía corta para elegir. - [Quickstart](https://devlab.neurologyca.com/docs/es/start/quickstart.md): De tu API key a tus primeros indicadores: con el SDK en una página tuya, con cURL o con Python. - [Integrar con tu agente de código](https://devlab.neurologyca.com/docs/es/start/ai-agents.md): Instala las skills de Neurologyca en tu agente de código, pega el índice en AGENTS.md y pídele la integración. Sigue los pasos verificados de esta documentación, sin adivinar rutas. - [Dispositivos, calidad y modo](https://devlab.neurologyca.com/docs/es/start/devices-and-modes.md): Qué modo encaja con los dispositivos de tu gente, qué depende del dispositivo, cómo comprobarlo antes de medir y cómo leer después el ritmo de la sesión. - [Solo medir](https://devlab.neurologyca.com/docs/es/guides/measurement.md): Envía datos de captura y recibe Human Context Indicators, sin interpretación. - [Instalación](https://devlab.neurologyca.com/docs/es/start/install.md): Instala @neurologyca/capture 0.45.0 y @neurologyca/capture-server 0.20.1 desde el registro privado de Neurologyca. - [Autenticación](https://devlab.neurologyca.com/docs/es/start/authentication.md): Cambia tu API key por un token de vida corta, en tu servidor. - [Tus entornos](https://devlab.neurologyca.com/docs/es/start/environments.md): Pruebas y producción son dos entornos con su URL de Engine, su key y su cuenta de DevLab. Qué hay en cada uno y cómo pasar. - [Probar tu integración](https://devlab.neurologyca.com/docs/es/start/testing.md): Prueba con datos deterministas: tu sandbox, un vídeo tuyo, frames sintéticos para CI, el SDK con una cámara falsa, estados forzados y el webhook. - [Cómo funciona el SDK](https://devlab.neurologyca.com/docs/es/sdk.md): Las dos mitades del SDK, sus dos modos, qué decides tú y por qué el navegador no lleva token. - [En el dispositivo (tiempo real)](https://devlab.neurologyca.com/docs/es/sdk/on-device.md): El cliente en vivo: créalo sin token, captura step a step y lee el resultado, los avisos, el baseline, la transcripción y el flujo de eventos. - [Cargar los modelos](https://devlab.neurologyca.com/docs/es/guides/load-models.md): Las cinco maneras de cargar en el navegador los modelos de la cara y de la voz, cuál elegir, qué se descarga y de dónde, y cómo comprobarlo en tu app. - [Steps y marcado](https://devlab.neurologyca.com/docs/es/sdk/steps.md): Cómo conducir cada step sin componente: sus datos, quién lo cierra, el reloj, la comprobación de duraciones, el media que enseñaste y el manifiesto de una grabación. - [Los resultados en tu backend](https://devlab.neurologyca.com/docs/es/sdk/results-backend.md): Cómo llegan los resultados en cada modo, el SDK y la API juntos, SSE o sondeo, el par que hay que guardar, las consultas puntuales y el webhook firmado del diferido. - [Tu backend](https://devlab.neurologyca.com/docs/es/sdk/backend.md): La mitad de servidor del SDK: el proxy que pone el token, tu sesión delante, createEngineAdmin, el receptor de subidas y la rotación de la key. - [Errores, avisos y reintentos](https://devlab.neurologyca.com/docs/es/sdk/errors.md): Cada error y aviso del SDK, por capa y por modo, lo que el SDK reintenta solo y qué mandar a soporte. - [Referencia del SDK](https://devlab.neurologyca.com/docs/es/sdk/reference.md): Cada export de @neurologyca/capture 0.45.0 y @neurologyca/capture-server 0.20.1, por entrada, con su firma y la página que lo explica. - [Diferido (en servidor)](https://devlab.neurologyca.com/docs/es/sdk/deferred.md): El cliente de grabación: graba el vídeo y un manifiesto de steps, súbelos a tu receptor y sigue el trabajo del servicio de procesado. - [Servicio de procesado](https://devlab.neurologyca.com/docs/es/sdk/processing.md): Qué hace nuestro servicio de procesado con una grabación, qué le expones, la URL del token, el webhook, sus códigos de error y Measurement en diferido. - [Timeouts](https://devlab.neurologyca.com/docs/es/guides/timeouts.md): Cuánto esperan el SDK, Engine y tu proxy, y cómo escalonarlos para que el problema lo informe la capa correcta. - [Guía de la API HTTP](https://devlab.neurologyca.com/docs/es/api.md): La API HTTP junto al SDK: llamadas puntuales y tu backend, y la captura completa por HTTP para quien captura fuera del navegador. - [Proxy a mano](https://devlab.neurologyca.com/docs/es/api/proxy.md): Las 13 rutas que llama el SDK de navegador, reenviadas a Engine por un proxy propio (Express o nginx), para cuando no usas capture-server. - [Referencia de la API](https://devlab.neurologyca.com/docs/es/reference.md): Todas las rutas de Engine 2, generadas del spec OpenAPI público. - [Protocolos y su jerarquía](https://devlab.neurologyca.com/docs/es/concepts/protocols.md): Qué publica Neurologyca para tu organización, qué ocurre por persona y dónde encajan las microintervenciones. - [Baseline](https://devlab.neurologyca.com/docs/es/concepts/baseline.md): Una captura de referencia por persona que calibra todos los protocolos. Engine la recomienda, avisa cuando falta y nunca bloquea sin ella. - [Cómo capturar para la máxima precisión](https://devlab.neurologyca.com/docs/es/concepts/capture.md): Las condiciones que de verdad comprueban Engine y Capture, lo que les falta a los primeros segundos de una captura y las recomendaciones del whitepaper. - [Sesiones, inscripciones e interrupciones](https://devlab.neurologyca.com/docs/es/concepts/sessions.md): Cómo se abre, se cierra, se abandona y se reinicia una captura, cómo responden los relojes de las posiciones y cómo se ofrecen las microintervenciones. - [HCIs y resultados](https://devlab.neurologyca.com/docs/es/concepts/results.md): Qué es un Human Context Indicator, la forma de los resultados, los eventos en vivo y la interpretación para una audiencia. - [Mostrar y aprovechar los resultados](https://devlab.neurologyca.com/docs/es/guides/show-results.md): Qué enseñar primero cuando llegan los indicadores y la interpretación, qué llega en cada caso, dónde está el transcrito, qué guardar y cómo releer sin pagar. - [Uso responsable](https://devlab.neurologyca.com/docs/es/guides/responsible-use.md): Para qué no sirven nunca las lecturas, qué asume tu app cuando las usa y qué hace Neurologyca por su parte. - [Límites declarados y modos de fallo](https://devlab.neurologyca.com/docs/es/concepts/limits.md): Lo que Engine no hace, los límites técnicos, los fallos que aun así responden 2xx y los cuerpos de error. - [CSP y transcripción](https://devlab.neurologyca.com/docs/es/guides/csp-transcription.md): Los orígenes externos que carga Capture, una Content Security Policy que funciona con ellos, cómo alojarlos tú y cómo configurar la transcripción. - [Antes de producción](https://devlab.neurologyca.com/docs/es/guides/production-checklist.md): Una lista por modo antes de capturar con personas reales en producción. - [Tu cuenta de DevLab](https://devlab.neurologyca.com/docs/es/access/account.md): Invitación, inicio de sesión, sesiones, revelado de la key de tu equipo y qué registra DevLab sobre ti. - [Keys: rotación, revocación y caducidad](https://devlab.neurologyca.com/docs/es/access/keys.md): Qué pasa cuando cambia la key de tu equipo y qué hacer en tu backend. - [Tu kit](https://devlab.neurologyca.com/docs/es/access/kit.md): Qué contiene el kit de un protocolo, dónde está en DevLab, qué es cada fichero y cada variable, dónde está la URL de Engine y cómo ejecutar un starter. - [Dónde está cada cosa](https://devlab.neurologyca.com/docs/es/access/map.md): Todas las pantallas de DevLab para un developer y para un admin de la organización: dónde están, qué tienen, qué puedes copiar y qué ves cuando falta algo. - [Modelo de acceso](https://devlab.neurologyca.com/docs/es/access/model.md): Organización, equipos, keys y usuarios finales: qué aísla Engine y dónde DevLab añade sus propios límites. - [Precios](https://devlab.neurologyca.com/docs/es/access/pricing.md): Los precios se publicarán pronto: cuánto cuesta Neurologyca, qué puedes usar sin coste y por qué integrar Neurologyca en una aplicación exige antes un acuerdo comercial. - [Para agentes de IA](https://devlab.neurologyca.com/docs/es/resources/agents.md): Versiones en texto plano de esta documentación, las skills para agentes, el índice y los conjuntos para agentes de código y LLMs. - [Trampas conocidas](https://devlab.neurologyca.com/docs/es/resources/pitfalls.md): Las trampas de integración que hemos medido, por vía: el síntoma que ves, su causa y qué hacer. Generadas de una sola fuente. - [Fases de lanzamiento](https://devlab.neurologyca.com/docs/es/resources/release-phases.md): Qué significan Preview y Próximamente, quién accede a cada una, qué puede cambiar y dónde se avisa. - [Changelog del SDK](https://devlab.neurologyca.com/docs/es/resources/changelog.md): Lo nuevo de cada versión del SDK y de capture-server, los cambios incompatibles y la política de compatibilidad de la línea 0.x. - [Privacidad y datos](https://devlab.neurologyca.com/docs/es/resources/privacy.md): Qué hace cada modo con los datos, para que puedas redactar tu consentimiento y tu registro de tratamiento: qué sale del dispositivo, la retención capa a capa, qué guarda el SDK en el navegador, Engine y DevLab. - [Migrar desde Engine 1.5](https://devlab.neurologyca.com/docs/es/resources/migration.md): Qué cambia al pasar una integración de Engine 1.5 a Engine 2, ruta por ruta. ## Optional - [Full documentation](https://devlab.neurologyca.com/docs/llms-full.txt): every English page in one file - [Small documentation](https://devlab.neurologyca.com/docs/llms-small.txt): the same, shorter