Create API - Veryfront

Prerequisites

The assistant agent from Create agent.
An API route directory. For a minimal setup, run mkdir -p app/api/ag-ui.
Access to model inference. Use a direct provider API key, a configured local model, or Veryfront Cloud. See Providers.

Create the route

Create app/api/ag-ui/route.ts:

// app/api/ag-ui/route.ts
import { createAgUiHandler } from "veryfront/agent";

export const POST = createAgUiHandler("assistant");

This route exposes the assistant agent at POST /api/ag-ui and streams AG-UI events to the chat UI.

Run it

Start the dev server:

veryfront dev

Verify it worked

Send a chat message from another terminal:

curl -N -X POST http://localhost:3000/api/ag-ui \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"id":"1","role":"user","parts":[{"type":"text","text":"What is Veryfront in one sentence?"}]}]}'

The -N flag tells curl to flush each chunk as it arrives. The curl response should emit data: lines as the answer streams. If the dev server logs a missing-provider error, configure one inference option from Providers, then restart veryfront dev. For non-agent endpoints, see API routes.