Code your agent. Keep your runtime.
@theokit/sdk is the agent SDK of the Theo ecosystem. TypeScript-first, multi-provider, Apache-2.0 local runtime, opt-in TheoCloud runtime. Use it standalone in an existing Express/Fastify/NestJS app — or pick up TheoKit when you need the full framework.
$ pnpm add @theokit/sdk
What you get
- TypeScript-first agent SDK — Agent.create(), Agent.send(), defineTool
- Multi-provider via pi-ai: Anthropic, OpenAI, Google, xAI, Mistral, Groq, Cohere, Vertex, Bedrock, Ollama, vLLM
- Local runtime (Apache-2.0) + opt-in TheoCloud runtime
- Streaming events: assistant, thinking, tool_call, status, task
- Sticky model override per-run without redeploy
- Composable with Theo Memory (@usetheo/memory) and Theo Knowledge (@usetheo/rag)
Use the SDK standalone
Embedding in an existing app
You have an Express/Fastify/NestJS/Hono codebase and want to add an agent without adopting a new framework.
Library-shaped agents
You ship an agent as part of a larger product (CLI, library, internal tool) and do not need full-stack framework features.
CI / cron / background agents
Your agent runs as a job — no HTTP endpoint, no UI. The SDK handles the agent loop, the rest is your code.
Use TheoKit (recommended)
Building a customer-facing app
You need routes, auth, sessions, real-time, deploy — the surface around your agent. TheoKit ships all of this.
You want one framework, not five libs
TheoKit includes the SDK, plus RAG, memory, and UI components. One install, one mental model.