Install Ratel
Get Ratel running in about five minutes
The Ratel SDK is one package you call directly from your own agent code — no service to run. Register your own tools and skills on a ratel() core, then hand any agent loop the same three capability tools.
For your own agent code
Ratel SDK: TypeScript & Python
Everything the SDK hands you is a plain executable tool: metadata plus an execute handler that plugs into any agent loop. Nothing on this page calls a model, so no API key is needed.
01
Install the SDK
bash
npm install @ratel-ai/sdkRequires Node.js 20 or newer.
02
Register a tool
typescript · index.ts
import { ratel } from "@ratel-ai/sdk";
const r = ratel();
await r.tools.register({
id: "get_weather",
name: "get_weather",
description: "Get the current weather for a city.",
inputSchema: {
type: "object",
properties: { city: { type: "string", description: "City name" } },
required: ["city"],
},
execute: async ({ city }) => ({ city, temperatureC: 24, condition: "sunny" }),
});
// Always all three. The set never depends on registration order.
const { search_capabilities, invoke_tool, get_skill_content } = r.modelTools();The three capability tools are always exposed together, in the same shape, regardless of registration order.
03
Run it
bash
npx tsx index.tsHow it fits together
One small, stable tool contract sits between your agent and everything else. Upstream schemas and skill bodies stay out of the prompt until a search makes them relevant.
