Theo Docs
TheoKitTheoKit-SDKTheoUITheo PaaS

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.

Quickstart →

What's included

  • Agent loop — typed Agent.create, agent.send, persistence, fork, handoffs, workflows, batching, eval suite.
  • Tools + MCPdefineTool with 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();

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).

On this page