TypeScript SDK

The kirha package is a fully typed TypeScript client for Kirha's real-time data layer. It handles authentication, tool planning, provider orchestration, and response parsing so you can focus on building your agent logic.

With the SDK you can:

• Search across premium data providers with a single natural language query
• Plan and execute workflows where you review providers and costs before running the query
• Run async tasks for complex research queries with multi-vertical search and multi-agent validation
• Execute tools directly give your agent direct access to the data providers without kirha orchestration
• Run the planner locally orchestrate queries on your own machine for privacy

Installation

npm install kirha

pnpm add kirha

yarn add kirha

bun add kirha

Setup

Initialize the client with your API key and a vertical:

import { Kirha } from "kirha";

const kirha = new Kirha({
  apiKey: process.env.KIRHA_API_KEY,
  vertical: "crypto",
});

Run your first query

import { Kirha } from "kirha";

const kirha = new Kirha({
  apiKey: process.env.KIRHA_API_KEY,
  vertical: "crypto",
});

const result = await kirha.search("What is the current price of Bitcoin?"); 
console.log(result.data); 

Run a deep research task

For complex research queries that need multiple verticals and multi-agent validation, use kirha.task():

import { Kirha, TaskStatus } from "kirha";

const kirha = new Kirha({
  apiKey: process.env.KIRHA_API_KEY,
});

const task = await kirha.task("Compare the AI strategies of Google, Microsoft, and Meta"); 
const result = await task.wait(); 

if (result.status === TaskStatus.Completed) {
  console.log(result.result);
}

Error handling

All errors extend the base KirhaError class:

Next steps