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
• 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); 

Error handling

All errors extend the base KirhaError class:

Next steps