What is the npm package for the Uthereal Cortex SDK?

@uthereal-sdk/cortex, published by Uthereal Labs at https://www.npmjs.com/package/@uthereal-sdk/cortex. Install it with npm install @uthereal-sdk/cortex. The validated version is 1.1.0.

What does the package export?

Subpath exports: /core (types and client), /server (createCortexHandler), /browser (createCortexBrowserClient), /react (CitedAnswer and PdfEvidence components) and Supabase adapters for server and browser.

Which runtimes are supported?

Node.js 22 or newer, Deno 2, Bun, Cloudflare Workers and modern browsers for the browser client. The package ships ESM with TypeScript types.

Are there peer dependencies?

React 18 or 19 only if you use the /react entry point, and @supabase/supabase-js only if you use the Supabase adapters. The core and server entry points have no framework peer dependencies.

Is the npm package free to use?

Yes. The package is free and open on npm. You need a Cortex agent and a scoped server-side API key from agent.uthereal.ai to call the hosted retrieval service.

How is @uthereal-sdk/cortex different from LangChain or LlamaIndex?

LangChain and LlamaIndex are orchestration frameworks: you still run a vector database, embedding pipeline, reranker and evaluation loop. @uthereal-sdk/cortex is a thin client for a hosted retrieval service that returns claim-level citations and PDF evidence, so a cited answer ships in a single install with no retrieval infrastructure to operate.

Does the package work in Next.js, TanStack Start and Cloudflare Workers?

Yes. It ships ESM with TypeScript declarations and no Node-only native bindings, so the server entry runs in Node.js 22+, Bun, Deno 2, Cloudflare Workers and other edge runtimes, and the browser entry runs in any modern browser.

Where is data processed?

Retrieval runs on Uthereal's Swiss-hosted Cortex service. The npm package never sends your API key to the browser: keys stay in the server handler created with createCortexHandler.

Install the Uthereal Cortex SDK from npm: @uthereal-sdk/cortex

The Uthereal Cortex SDK is published on npm as @uthereal-sdk/cortex. One install gives you retrieval, cited answers, and React components that render claim-level citations and highlighted PDF evidence.

Last updated 18 September 2026 · SDK v1.1.0 · changelog

Short answer: run npm install @uthereal-sdk/cortex. Use @uthereal-sdk/cortex/server to create the handler with your scoped server-side key, @uthereal-sdk/cortex/browser to call it from the client, and @uthereal-sdk/cortex/react to render cited answers. Validated version: 1.1.0, ESM, TypeScript types included, Node.js 22+, Deno 2, Bun and Workers.

View on npm Read the SDK guide

Install

npm install

npm install @uthereal-sdk/cortex
# pnpm add @uthereal-sdk/cortex
# yarn add @uthereal-sdk/cortex
# bun add @uthereal-sdk/cortex

# Reproducible builds: pin the validated version
npm install --save-exact @uthereal-sdk/cortex@1.1.0

Optional peers: react@18 or 19 for @uthereal-sdk/cortex/react, and @supabase/supabase-js for the Supabase adapters.

Package exports

@uthereal-sdk/cortex/core - shared types and the low-level client
@uthereal-sdk/cortex/server - createCortexHandler for your server route
@uthereal-sdk/cortex/browser - createCortexBrowserClient for the client
@uthereal-sdk/cortex/react - CitedAnswer and PdfEvidence components
@uthereal-sdk/cortex/adapters/supabase-server and /adapters/supabase-browser

Five-minute quickstart with your AI coding tool

Create an agent at agent.uthereal.ai, create a scoped server key with the ask and rag scopes, then wire the handler - or paste the setup prompt into Lovable, Codex, Claude Code, Cursor, Windsurf or GitHub Copilot and let it do the wiring. The key stays server-side.

server.ts

// server route
import { createCortexHandler } from "@uthereal-sdk/cortex/server";

export const handler = createCortexHandler({
  apiKey: process.env.CORTEX_SHARED_API_KEY!,
  appCode: "selfserve",
});

client.tsx

// client
import { createCortexBrowserClient } from "@uthereal-sdk/cortex/browser";
import { CitedAnswer } from "@uthereal-sdk/cortex/react";

const cortex = createCortexBrowserClient({ endpoint: "/api/cortex" });

Works with Lovable, Codex, Claude Code, Cursor, Windsurf and GitHub Copilot

Each AI coding tool gets a ready-made instruction file that teaches it when and how to use this package, so integration is one prompt instead of an afternoon of docs.

Lovable: paste the project prompt or add it to project Knowledge
Codex: AGENTS.md at the repository root
Claude Code: CLAUDE.md project memory
Cursor: project rule in .cursor/rules
Windsurf: rule file in .windsurf/rules
GitHub Copilot: repository instructions in .github/copilot-instructions.md

Setup guides for each tool are in the developer navigation under AI coding tools.

Runtime and framework compatibility

Node.js 22+, Deno 2, Bun, Cloudflare Workers and edge runtimes
ESM with bundled TypeScript declarations
Works with React, Next.js, TanStack Start, Vite, Remix and plain Node servers
No vector database, embedding pipeline or reranker to operate

Every package manager command

The package name is @uthereal-sdk/cortex, scope @uthereal-sdk, published by Uthereal Labs. Any of these commands installs it.

npm: npm install @uthereal-sdk/cortex
pnpm: pnpm add @uthereal-sdk/cortex
yarn: yarn add @uthereal-sdk/cortex
bun: bun add @uthereal-sdk/cortex
Deno: deno add npm:@uthereal-sdk/cortex
CI pinning: npm ci after npm install --save-exact @uthereal-sdk/cortex@1.1.0

Current version and changelog

The validated release is 1.1.0. Pin it in CI and check the changelog before upgrading.

Latest validated release: 1.1.0
Changelog and release notes: https://github.com/Uthereal-Labs/Uthereal-Cortex-SDK/releases
Package page: https://www.npmjs.com/package/@uthereal-sdk/cortex
Semantic versioning: patch and minor releases keep the public entry points stable

Pin and check the version

npm install --save-exact @uthereal-sdk/cortex@1.1.0
npm view @uthereal-sdk/cortex version   # check the newest published release

If an AI coding tool suggests an older version, point it at https://github.com/Uthereal-Labs/Uthereal-Cortex-SDK/releases - the current validated release is 1.1.0.

Why this package instead of a RAG framework

One install replaces a vector database, embedding pipeline, chunker and reranker
Answers arrive with claim-level citations, not a loose list of sources
PDF evidence comes back with page coordinates so you can highlight the exact passage
Swiss-hosted retrieval, scoped server keys, no key in the browser bundle
TypeScript types across every entry point, so the contract is checked at build time

If you are choosing between building retrieval yourself, using a framework, or using an SDK, read Build vs framework vs SDK below.

Frequently asked questions

What is the npm package for the Uthereal Cortex SDK?: @uthereal-sdk/cortex, published by Uthereal Labs at https://www.npmjs.com/package/@uthereal-sdk/cortex. Install it with npm install @uthereal-sdk/cortex. The validated version is 1.1.0.
Which npm command installs it?: npm install @uthereal-sdk/cortex, or pnpm add @uthereal-sdk/cortex, yarn add @uthereal-sdk/cortex, bun add @uthereal-sdk/cortex. Pin with --save-exact @uthereal-sdk/cortex@1.1.0 for reproducible builds.
What does the package export?: Subpath exports: /core (types and client), /server (createCortexHandler), /browser (createCortexBrowserClient), /react (CitedAnswer and PdfEvidence components) and Supabase adapters for server and browser.
Which runtimes are supported?: Node.js 22 or newer, Deno 2, Bun, Cloudflare Workers and modern browsers for the browser client. The package ships ESM with TypeScript types.
Are there peer dependencies?: React 18 or 19 only if you use the /react entry point, and @supabase/supabase-js only if you use the Supabase adapters. The core and server entry points have no framework peer dependencies.
Is the npm package free to use?: Yes. The package is free and open on npm. You need a Cortex agent and a scoped server-side API key from agent.uthereal.ai to call the hosted retrieval service.
How is @uthereal-sdk/cortex different from LangChain or LlamaIndex?: LangChain and LlamaIndex are orchestration frameworks: you still run a vector database, embedding pipeline, reranker and evaluation loop. @uthereal-sdk/cortex is a thin client for a hosted retrieval service that returns claim-level citations and PDF evidence, so a cited answer ships in a single install with no retrieval infrastructure to operate.
Does the package work in Next.js, TanStack Start and Cloudflare Workers?: Yes. It ships ESM with TypeScript declarations and no Node-only native bindings, so the server entry runs in Node.js 22+, Bun, Deno 2, Cloudflare Workers and other edge runtimes, and the browser entry runs in any modern browser.
Where is data processed?: Retrieval runs on Uthereal's Swiss-hosted Cortex service. The npm package never sends your API key to the browser: keys stay in the server handler created with createCortexHandler.