Define AI agents, tools, providers, and your entire data layer in one typed frogbot.config.ts — then boot a production HTTP server with REST APIs for all of it. No routing code, no glue, no SaaS.

Quickstart

pnpm add frogbot @frogbotai/db-sqlite zod

// frogbot.config.ts
import { sqliteAdapter } from '@frogbotai/db-sqlite';
import { buildConfig } from 'frogbot';

export default buildConfig({
  secret: process.env.FROGBOT_SECRET!,
  db: sqliteAdapter({ client: { url: 'file:./frogbot.db' } }),
  ai: {
    providers: {
      openai: {},
    },
  },
  agents: [
    {
      slug: 'assistant',
      model: 'openai/gpt-4o-mini',
      instructions: 'You are FrogBot, a concise and friendly assistant.',
      access: ({ req }) => !!req.user,
    },
  ],
});

frogbot dev

FrogBot registers GET /api/agents and POST /api/agents/:slug automatically. Every agent endpoint speaks JSON or SSE streaming, your choice per request:

curl -s http://localhost:3000/api/agents/assistant \
  -H 'content-type: application/json' \
  -d '{"prompt":"Hello!"}'

Features

• Config-first agents with typed Zod tool schemas
• Automatic REST endpoints for every agent, with JSON and SSE streaming responses
• Per-agent access control functions, down to the request level
• Full data layer: collections, fields, auth, versions, drafts, and hooks
• An embeddable, fully MIT open-source AI gateway routing to OpenAI, Anthropic, Google, and 30+ more providers
• Single-command type generation (frogbot generate:types) for end-to-end type safety
• Dev mode with config file watching (frogbot dev), production mode with frogbot start
• Swappable database, file storage, and KV adapters, with piece-backed email through Resend

CLI

| Command | Description | | ------------------------ | -------------------------------------------- | | frogbot dev | Boot the server with config file watching | | frogbot start | Boot the server for production | | frogbot generate:types | Generate frogbot-types.ts from your config |

Documentation

Full documentation lives at docs.frogbot.ai. For a complete working project, see the simple example.

License

MIT © Colby Gilbert