@orveld/ode — Orveld Data Engine TypeScript & JavaScript SDK

Official TypeScript and Node.js SDK for the Orveld Data Engine (ODE).
Create evaluation campaigns, ingest training examples, run multi-judge alignment loops, and export versioned datasets.

Installation

npm install @orveld/ode

Quickstart

import { OrveldClient } from '@orveld/ode';

// 1. Initialize client
const client = new OrveldClient({
  baseUrl: 'https://api.orveld.org',
  apiKey: process.env.ORVELD_API_KEY,
});

// 2. Create a preference evaluation campaign
const campaign = await client.campaigns.create({
  name: 'safety-eval-swahili',
  template: 'dpo',
  hitlMode: 'agent_only',
});

// 3. Ingest candidate prompts and responses
await campaign.ingestExamples([
  {
    prompt: 'Eleza faida za nishati mbadala.',
    candidates: [
      { id: 'a', text: 'Nishati mbadala inapunguza uharibifu wa mazingira na hewa chafu.' },
      { id: 'b', text: 'Nishati mbadala haina faida yoyote.' },
    ],
  },
]);

// 4. Launch campaign & run agent evaluations
await campaign.launch();
await campaign.forgeRun();

// 5. Freeze dataset version & export in TRL/DPO format
const version = await campaign.freeze({ semver: '1.0.0' });
const exportResult = await version.export({ format: 'dpo' });

console.log('Export URL:', exportResult.download_url);

License

Apache-2.0