Skip to content

Embedding Pensieve in React ​

@pensieve-ai/react is an Apache-2.0 licensed embeddable SDK that drops five production-quality Pensieve views — Graph, Query Editor, Discover, Dashboards, and Agent Chat — into any React 18+ host application. Each view is a fully self-contained component backed by the same UI rendered in the Pensieve web app itself.

In this section ​

PageWhat it covers
QuickstartInstall, wire the provider, render a view in under 20 lines
AuthenticationStatic tokens, server-side minting, full OIDC setup
CORSPENSIEVE_CORS_ALLOWED_ORIGINS — permissive dev vs. production lock-down
ThemingAll 26 design tokens, presets, partial overrides, inherit mode
ComponentsPer-component prop tables and bundle notes
Headless hooksRaw data layer without the bundled UI
Server compatibilityFeature detection, capability gating, known limitations
Versioning and releaseChangesets flow, semver policy

Reference demo ​

The examples/embed-demo package in the repository is a working reference host app that exercises every component and hook. Read examples/embed-demo/README.md to run it locally.

An open-source project · MIT licensed.