Skip to main content

Broods

Broods runs AI agents for you. You describe an agent in TypeScript, with its model, its tools, where it runs code, and which chat apps it answers in. broods deploy puts it in the cloud. You then call it from your app, a terminal, Slack, Telegram, or a schedule.

broods/index.ts
import { defineAgent, env } from "broods";

export const support = defineAgent({
name: "support",
provider: { openai: { apiKey: env("OPENAI_API_KEY") } },
model: { provider: "openai", modelId: "gpt-5.5" },
agent: { system: "You answer customer questions about our product." },
publicAccess: true,
});
broods dev # sync to your development stage, watch for changes
broods run support "Hi there" # chat with it in the terminal

What you get​

  • Agents with any AI SDK model provider, streaming, structured output, and reasoning.
  • Sandboxes where the agent runs bash, Python and Node. They run on Broods-hosted Firecracker VMs, AWS Lambda MicroVMs, Daytona, E2B, Vercel, or your own computer.
  • Workspaces with persistent files and memory. They survive between runs and several agents can share one.
  • Channels for Telegram, Slack, Discord, GitHub, Linear, Pancake, Zalo, WhatsApp, Teams, Google Chat, Twilio SMS, Messenger and Instagram, each on its own webhook URL under the account.
  • Tools from your model provider or any MCP server, including servers Broods hosts for you.
  • Skills, subagents, cron jobs, code hooks, lifecycle webhooks, and policies.
  • A typed SDK, a raw HTTP and WebSocket API, a CLI, and a dashboard for logs, traces and config.

Start here​

If you want toRead
Deploy your first agent in five minutesQuickstart
Understand projects, stages, agents and keysConcepts
Configure an agent's model, prompt and behaviorAgents
Let the agent run code or keep filesSandboxes
Put the agent in Slack, Telegram or DiscordChannels
Call the agent from your appSDK reference
Call it from another languageHTTP API
Look up a CLI commandCLI reference
Look up every config fieldConfiguration
Self-host or contribute to BroodsInternals

Runnable examples for most features live in packages/demos.

Get help​

Open an issue on GitHub.