Installation

Requirements

Node.js >= 18
npm, pnpm, or yarn

Install the core package

For most use cases, install @kyro/judge:

npm install @kyro/judge

If you also need the unified entry point (re-exports judge + shared):

npm install @kyro/core

Install by use case

ℹInfo

All packages are independent — install only what you need.

Use case	Package
LLM evaluation pipelines	`@kyro/judge`
Human conversation simulation	`@kyro/actor`
Async batch evaluation at scale	`@kyro/batch`
AI provider abstraction only	`@kyro/shared`
Everything (re-export)	`@kyro/core`

# Evaluation engine
npm install @kyro/judge
 
# Actor (add WebSocket support)
npm install @kyro/actor ws
 
# Batch evaluation
npm install @kyro/batch
 
# All-in-one
npm install @kyro/core

Configure your AI provider

Kyro delegates all AI calls to a Provider. Create one with ProviderFactory:

import { ProviderFactory } from '@kyro/shared';
 
// OpenAI
const provider = ProviderFactory.create({
  provider: 'openai',
  model: 'gpt-4o',
  apiKey: process.env.OPENAI_API_KEY,
});
 
// Anthropic
const provider = ProviderFactory.create({
  provider: 'anthropic',
  model: 'claude-opus-4-6',
  apiKey: process.env.ANTHROPIC_API_KEY,
});
 
// Google Gemini
const provider = ProviderFactory.create({
  provider: 'gemini',
  model: 'gemini-2.0-flash',
  apiKey: process.env.GEMINI_API_KEY,
});

Supported providers: openai, anthropic, gemini, azure, ollama.

Python support

⚠Warning

The Python package is coming soon. Check back or watch the GitHub repo.

Requirements

Install the core package

Install by use case

Configure your AI provider

Python support

On this page