TypeScript SDK

The kirha package is a fully typed TypeScript client for the KIRHA API. 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 to give your agent access to the data providers without KIRHA's planning
• Run the planner locally to plan queries on your own machine

Installation

npm install kirha

pnpm add kirha

yarn add kirha

bun add kirha

Setup

Initialize the client with your API key:

import { Kirha } from "kirha";

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

Run your first query

import { Kirha } from "kirha";

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

const result = await kirha.search("What does the boxed warning on Ozempic say?"); 
console.log(result.data); 

KIRHA picks the providers across every vertical. To restrict a search to one vertical, pass focus, in the constructor or per query:

const result = await kirha.search("List top 10 stablecoins yield on Ethereum", {
  focus: "crypto", 
});

Error handling

All errors extend the base KirhaError class:

Next steps