← Back to Docs

SDKs & Libraries

Pre-built SDKs for React, Python, and Node.js. Get from install to first cognitive score in under 2 hours.

React / Next.js

Install
npm install @dicorner/react-sdk
Quick Start
import { DiCornerProvider, useScores, useNBA } from '@dicorner/react-sdk';

// Wrap your app
function App() {
  return (
    <DiCornerProvider apiKey="dc_free_your_key">
      <YourApp />
    </DiCornerProvider>
  );
}

// Use in any component
function PricingPage() {
  const { scores, loading } = useScores('current-user-id');
  const { recommendations } = useNBA('current-user-id');

  // Track events automatically
  // DiCorner SDK auto-captures page views, scroll depth, dwell time

  if (scores?.decision_fatigue_index?.level === 'critical') {
    // Show simplified pricing (NBA recommendation)
    return <SimplifiedPricing />;
  }

  return <FullPricing />;
}

Python

Install
pip install dicorner
Quick Start
from dicorner import DiCornerClient

client = DiCornerClient(api_key="dc_free_your_key")

# Send events
client.track(
    user_id="usr_12345",
    event_type="page_view",
    page="pricing",
    properties={"dwell_time_ms": 45000}
)

# Get cognitive scores
scores = client.get_scores("usr_12345")
print(f"Decision Fatigue: {scores.dfi.value} ({scores.dfi.level})")

# Get NBA recommendations
nba = client.get_nba("usr_12345")
for rec in nba.recommendations:
    print(f"[{rec.tier}] {rec.action} (Confidence: {rec.confidence})")

Node.js

Install
npm install @dicorner/node-sdk
Quick Start
import { DiCorner } from '@dicorner/node-sdk';

const dc = new DiCorner({ apiKey: 'dc_free_your_key' });

// Send events
await dc.track({
  userId: 'usr_12345',
  eventType: 'page_view',
  page: 'pricing',
  properties: { dwellTimeMs: 45000 }
});

// Get cognitive scores
const scores = await dc.getScores('usr_12345');
console.log(`DFI: ${scores.decisionFatigueIndex.value}`);

// Get NBA recommendations
const nba = await dc.getNBA('usr_12345');
nba.recommendations.forEach(rec => {
  console.log(`[${rec.tier}] ${rec.action}`);
});

Webhooks (Growth + Enterprise)

Receive real-time notifications when cognitive scores cross critical thresholds. Configure webhooks in your dashboard or via API.

Webhook Payload
{
  "event": "score_threshold_crossed",
  "user_id": "usr_12345",
  "metric": "decision_fatigue_index",
  "value": 85,
  "level": "critical",
  "previous_level": "elevated",
  "timestamp": "2026-02-13T10:30:00Z",
  "nba": {
    "tier": "do_now",
    "action": "Simplify pricing comparison"
  }
}

Need help with integration?