Get Started

Create a Better Agent app, define one agent, and run it locally.

Install

Install the core package and a provider:

npm install @better-agent/core @better-agent/openai

Use the CLI when you want a full framework scaffold:

npx create-better-agent

Create an agent

An agent is a name, a model, and an instruction.

// lib/better-agent/server.ts
import { defineAgent, betterAgent } from "@better-agent/core";
import { openai } from "@better-agent/openai";

const supportAgent = defineAgent({
  name: "support",
  model: openai("gpt-5.5"),
  instruction: "You help customers.",
});

export const app = betterAgent({
  agents: [supportAgent],
});

betterAgent() wires agents into a typed app.

Run it

const result = await app.agent("support").run({
  messages: [{ role: "user", content: "Help me write a refund policy." }],
});

console.log(result.messages);

Serve over HTTP

app.handler is a standard Request to Response function. Mount it in any framework route.

Bun.serve({
  port: 3000,
  fetch: app.handler,
});

See Integrations for framework-specific routes.

Next