Guided setup
From the root of your agent project, run the published setup wizard:npm
CLI Install
Install the Sentrial CLI:npm
npm
One-Line Bootstrap
Use the published npm package from your agent project’s root. This is the same wizard as guided setup above; a separate shell installer is not required.npm
Options
npx may download the package from npm. The wizard’s dry-run itself does not
install SDKs into your project, write examples or send telemetry. For a Python-only
environment without Node.js, use the manual Python installation below.
Python
Basic Installation
With LangChain Support
Requirements
- Python 3.9 or higher
requestslibrary (installed automatically)langchain-core(optional, for LangChain integration)
TypeScript / Node.js
Requirements
- Node.js 18 or higher
- TypeScript 5.0+ (for TypeScript projects)
Configuration
Environment Variables (Recommended)
Set your API key as an environment variable for automatic configuration:Python Configuration
TypeScript Configuration
Getting Your API Key
1
Sign in to Sentrial
Go to sentrial.com and sign in.
2
Go to Settings
Navigate to Settings → API Keys in the sidebar.
3
Create API Key
Click “Create API Key”, give it a name, and copy the key.
Verify Installation
Run the generated example or the complete first-trace quickstart. The quickstart waits for telemetry delivery and prints a session ID. Open that session in Telemetry in the same workspace and check its input, tool result and final output. For delivery diagnostics in a Node.js environment:sessions:read and
events:read. It reads existing data without sending traces or running a model.
See Doctor results for missing credentials, incomplete delivery and
other checks that need attention.
A session ID confirms that the session was acknowledged. Inspecting its events
establishes what was received; neither step by itself verifies a signal prediction.
Next Steps
Quick Start
Send a first trace and inspect its tool evidence.
Python SDK Reference
Complete API reference.

