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

> Install @uthereal-sdk/cortex from npm to add cited, source-grounded RAG answers to any TypeScript app. Built for AI coding tools: Lovable, Codex, Claude Code, Cursor, Windsurf and GitHub Copilot can wire it in for you.

- Canonical page: https://uthereal.ai/developers/npm
- Last updated: 2026-09-18
- Product: Uthereal Cortex (sovereign enterprise AI, Swiss/EU data residency)
- npm package: `@uthereal-sdk/cortex` (https://www.npmjs.com/package/@uthereal-sdk/cortex)
- Repository: https://github.com/Uthereal-Labs/Uthereal-Cortex-SDK

## Short answer

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.

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.

## 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
```
_npm install_

> 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 route
import { createCortexHandler } from "@uthereal-sdk/cortex/server";

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

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

const cortex = createCortexBrowserClient({ endpoint: "/api/cortex" });
```
_client.tsx_

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

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

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

## Related pages

- [SDK overview](https://uthereal.ai/developers/sdk): Full setup, API reference and FAQ.
- [RAG with citations](https://uthereal.ai/developers/rag-with-citations): How cited answers are built.
- [Build vs framework vs SDK](https://uthereal.ai/developers/rag-sdk-comparison): What DIY retrieval really costs.
- [What Cortex is](https://uthereal.ai/cortex): The platform behind the package.

## Next steps

- Create an agent and a scoped server key: https://agent.uthereal.ai
- Full SDK guide (HTML): https://uthereal.ai/developers/sdk
- Full SDK guide (Markdown): https://uthereal.ai/developers/sdk.md
- AI index for this site: https://uthereal.ai/llms.txt and https://uthereal.ai/llms-full.txt
- Help: sdk@uthereal.ai