Start Here

camelRun

A hosted runtime for durable agents. Your tools stay in your code; camelRun runs the model loop, keeps history and files, and wakes agents when there is work.

camelRun is camelAI's hosted agent runtime. You define an agent's tools in your own code with the TypeScript or Python SDK, or serve them over HTTP. camelRun runs the model loop, keeps each agent's history and files, compacts long conversations, runs model-written code in a sandbox, and wakes agents when there is work. Most agents are asleep at any moment and cost nothing while they are.

import { Agents } from "@camelai/run";

const agents = new Agents(); // reads CAMELAI_API_KEY
const agent = await agents.upsert("support-triage", {
  model: "anthropic/claude-sonnet-5-5",
  instructions: "Be concise.",
});
console.log((await agent.run("Which tickets look urgent?")).text);
await agents.close();


API	`https://run.camelai.com/v1`
Console	run.camelai.com/console
OpenAPI spec	`/v1/openapi.json`
Docs for agents	`/llms.txt`
Source	github.com/qaml-ai/run

What you get

Durable, keyed agents

The same key is the same agent, with its history and files, from any process, until you delete it.

Tools in your code

Tools run in your process or on your HTTPS endpoint, with your credentials. MCP servers and OpenAPI specs work too.

People in the loop

Approvals, questions and forms suspend a run for days, then resume it where it stopped.

Chat UI in minutes

React, Vue, Svelte and Solid components stream an agent into your app without exposing your API key.

Channels

Slack, Telegram, Discord, GitHub and any service that sends webhooks can start and talk to agents.

Agents as MCP servers

Every agent is an MCP server, so Claude, Cursor or any MCP client can message it.

Any model

Pick from the catalog, bring your own provider keys, or add a model server of your own.

Start here

Quickstart

An agent that calls a tool in your process, in five minutes.

Build a chat app

A streaming chat with your users' agents, from one command.

Concepts

Keyed agents, runs, events, and where tools run.

CLI and MCP server

Deploy and manage agents from a terminal, or from a coding agent.

Packages

Package
`@camelai/run` (npm)	TypeScript SDK: Node 22+, Bun, Deno, Cloudflare Workers
`camelai-run` (PyPI)	Python SDK: Python 3.11+
`@camelai/run-react`	Chat components and hooks. Vue, Svelte and Solid bindings are `@camelai/run-vue`, `-svelte` and `-solid`
`@camelai/create-run-app`	`npm create @camelai/run-app` scaffolds a Next.js chat app
`@camelai/camelrun`	The `camelrun` CLI and local MCP server

Licensing

The camelRun runtime is licensed under the GNU AGPL-3.0. The SDKs, frontend packages, CLI and examples are MIT, so you can use them in any application. Commercial licenses for the runtime are available: contact us through camelai.com. See Self-hosting to run the runtime yourself.

PreviousSet per-user spend limits Next Quickstart