@runbit/runtime

The AI Runtime. Build production AI systems, not prompt chains.

npm install @runbit/runtime @runbit/openai

import { runtime, agent, tool } from "@runbit/runtime";
import { openai } from "@runbit/openai";

const app = runtime();

const weather = tool({
  name: "weather",
  description: "Get the weather for a city.",
  parameters: { type: "object", properties: { city: { type: "string" } }, required: ["city"] },
  run: ({ city }) => ({ city, sky: "sunny", tempC: 27 }),
});

const assistant = agent({ model: openai("gpt-4o-mini"), tools: [weather] });

const result = await app.run(assistant, { message: "Plan my trip to Tokyo" });
console.log(result.text);

If you can read that in ten seconds, you already know Runbit.

Why

React  = UI Runtime
Node   = Server Runtime
Docker = Container Runtime
Runbit = AI Runtime

Not another agent framework — the runtime every agent framework wishes it had. Everything runs through one small, event-driven core; everything else is a package on top.

The umbrella

@runbit/runtime re-exports the whole surface, so one install gets you everything:

| Re-exported from | You get | | --- | --- | | @runbit/core | Runnable, Context, RunbitError, state, logger | | @runbit/tool | tool(), tool registry | | @runbit/model | ChatModel, defineModel | | @runbit/agent | agent(), team() | | @runbit/workflow | sequence, parallel, branch, retry, timeout | | @runbit/memory | MemoryStore, VectorStore, memoryStore() | | @runbit/rag | knowledge() | | @runbit/events · @runbit/plugin | event bus · plugin contract |

Providers (@runbit/openai) and devtools (@runbit/devtools) ship separately.

Runtime API

const app = runtime({ logger });

await app.run(fn);                 // run any async function
await app.run(runnable, input);    // run an agent / workflow / tool
app.use(plugin);                   // add a provider, tracer, or devtools
app.tool(tool);                    // register a global tool
app.on((event) => { ... });        // subscribe to every event
app.stop();                        // cancel all in-flight runs

Every step emits start/end events — the foundation for tracing, replay, and @runbit/devtools.

Part of Runbit — the AI Runtime. Everything executes through one small, event-driven runtime; agents, workflows, RAG, and observability are packages on top.

• Umbrella: @runbit/runtime
• License: MIT