TheoKit-SDK
Build agents in TypeScript — local-first, multi-provider, Apache-2.0.
Build agents in TypeScript. Local-first, multi-provider, Apache-2.0. Bring your own keys, walk away anytime.
What's included
- Agent loop — typed
Agent.create,agent.send, persistence, fork, handoffs, workflows, batching, eval suite. - Tools + MCP —
defineToolwith Zod schemas, plus first-class MCP client (stdio + HTTP + OAuth 2.1 PKCE). - Memory — Active Memory built on SQLite + FTS5 + sqlite-vec by default; LanceDB opt-in; pluggable adapters.
- 9 builtin providers — OpenAI, OpenRouter, Anthropic, Gemini, Ollama, LM Studio, llama.cpp, AWS Bedrock, GCP Vertex.
Quick code
import { Agent } from "@theokit/sdk";
const agent = await Agent.create({
apiKey: process.env.OPENROUTER_API_KEY,
model: { id: "openai/gpt-4o-mini" },
});
const run = await agent.send("What is 2+2?");
console.log((await run.wait()).result); // "4"
await agent.dispose();Navigate
Getting started
Install + quickstart + your first real agent in 15 minutes.
Concepts
Agent, tools, memory, MCP, hooks, workflows, cache, gateways, errors, and more.
API reference
Auto-generated from TypeDoc — every exported symbol.
Cookbook
Runnable recipes for Bedrock, Vertex, handoffs, workflows, cache, Slack.
Why this stack
Apache-2.0 SDK. Apache-2.0 local runtime. Multi-provider keys. Opt-in cloud (Theo PaaS, pre-release). Walk-away cost: zero. No vendor lock at the SDK layer — if you stop using the SDK, your data and config stay yours on disk.
Status: v1.2 stable; v1.3 in progress (CLI, Eval, Handoffs, Workflows, Cache, Slack, Bedrock+Vertex shipped). Cloud runtime depends on Theo PaaS (pre-release).