Niitaka SDK

AI agent observability and control plane — one import away.

Niitaka instruments your AI agents to capture every LLM call, tool invocation, and decision trace. Connect to the Niitaka dashboard to run experiments, enforce guardrails, and version your agents — without changing your agent code.

Install

pip install niitaka-sdk                    # core
pip install "niitaka-sdk[openai]"          # + OpenAI
pip install "niitaka-sdk[anthropic]"       # + Anthropic
pip install "niitaka-sdk[all]"             # all providers

Quick start

import niitaka
import os

niitaka.configure(
    api_key=os.getenv("NIITAKA_API_KEY"),
    api_url="https://api.niitaka.ai",      # or your self-hosted URL
)

# Instrument your LLM provider (pick one or more)
niitaka.instrument_openai()
niitaka.instrument_anthropic()
niitaka.instrument_gemini()
niitaka.instrument_groq()

# Wrap your agent run in a session
with niitaka.start_session(goal="Summarise this document", agent_id="my-agent"):
    response = client.chat.completions.create(...)  # auto-logged

Every call inside start_session is automatically traced — latency, token usage, cost, errors, and tool calls.

Providers

Provider	Extra	Import
OpenAI	`niitaka-sdk[openai]`	`niitaka.instrument_openai()`
Anthropic	`niitaka-sdk[anthropic]`	`niitaka.instrument_anthropic()`
Google Gemini	`niitaka-sdk[gemini]`	`niitaka.instrument_gemini()`
Groq	`niitaka-sdk[groq]`	`niitaka.instrument_groq()`
LangChain	`niitaka-sdk[langchain]`	`from niitaka import NiitakaCallbackHandler`

LangChain

from niitaka import NiitakaCallbackHandler
import niitaka

with niitaka.start_session(goal="...", agent_id="lc-agent"):
    chain.invoke({"input": "..."}, config={"callbacks": [NiitakaCallbackHandler()]})

Runtime config

Niitaka can push model, temperature, and guardrail config to your agent at runtime — no redeploy needed:

config = niitaka.get_runtime_config(agent_id="my-agent")
# config["llm"]["model"], config["guardrails"]["cost_limit_usd"], ...

Release files for niitaka-sdk 0.1.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for niitaka-sdk 0.1.21
File	Size	Uploaded
niitaka_sdk-0.1.21.tar.gz	52.1 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for niitaka-sdk 0.1.21
File	Interpreter	ABI	Platform	Reset
niitaka_sdk-0.1.21-py3-none-any.whl 57.8 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 109.9 kB

Release files / niitaka_sdk-0.1.21.tar.gz

Download URL	niitaka_sdk-0.1.21.tar.gz
Size	52.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`d6e12168a931460cc255346d6771b8629d964376ee526de845e26f21033760e2`
BLAKE2b-256 checksum How to use checksums	`4eae53111fb67c0a21e40c50f5f9a78d8191ecb36c283f73dff9f23c709b4a81`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`

Release files / niitaka_sdk-0.1.21-py3-none-any.whl

Download URL	niitaka_sdk-0.1.21-py3-none-any.whl
Size	57.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`32ff3a5fcfe60d8f83f551eb6ed479bc09c02ade2c16abf1149cff5e27a94f96`
BLAKE2b-256 checksum How to use checksums	`18b59d59ddd928fa89aeed263839ea956a54da6e68c3fe1e792c6d56a502fbb8`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`