@reminix/vercel-ai

Reminix Runtime adapter for the Vercel AI SDK. Serve AI agents as a REST API.

Supports both:

- ToolLoopAgent - Full agents with tools and automatic tool loop handling
- Model - Simple completions via generateText/streamText without tools

> Ready to go live? Deploy to Reminix Cloud for zero-config hosting, or self-host on your own infrastructure.

Installation

``bash
npm install @reminix/vercel-ai ai @ai-sdk/openai
`

This will also install @reminix/runtime as a dependency.

Quick Start with Model

`typescript
import { openai } from '@ai-sdk/openai';
import { serveAgent } from '@reminix/vercel-ai';

const model = openai('gpt-4o');
serveAgent(model, { name: 'chat-agent', port: 8080 });
`

Quick Start with ToolLoopAgent

For agents with tools, use ToolLoopAgent:

`typescript
import { ToolLoopAgent, tool } from 'ai';
import { openai } from '@ai-sdk/openai';
import { z } from 'zod';
import { serveAgent } from '@reminix/vercel-ai';

const weatherTool = tool({
description: 'Get the current weather for a city',
inputSchema: z.object({
city: z.string()
}),
execute: async ({ city }) => {
return { city, temp: 72, condition: 'sunny' };
}
});

const agent = new ToolLoopAgent({
model: openai('gpt-4o'),
instructions: 'You help users check the weather.',
tools: { getWeather: weatherTool }
});

serveAgent(agent, { name: 'weather-agent', port: 8080 });
`

For more flexibility (e.g., serving multiple agents), use wrapAgent and serve separately:

`typescript
import { openai } from '@ai-sdk/openai';
import { wrapAgent } from '@reminix/vercel-ai';
import { serve } from '@reminix/runtime';

const model = openai('gpt-4o');
const reminixAgent = wrapAgent(model, { name: 'chat-agent' });
serve({ agents: [reminixAgent], port: 8080 });
`

Your agent is now available at:
- POST /agents//invoke - Execute the agent

API Reference

$3

Wrap a Vercel AI SDK model or agent and serve it immediately. Combines wrapAgent and serve for single-agent setups.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| modelOrAgent | ToolLoopAgent \| LanguageModel | required | A ToolLoopAgent or language model |
| options.name | string | "vercel-ai-agent" | Name for the agent (used in URL path) |
| options.port | number | 8080 | Port to serve on |
| options.hostname | string | "0.0.0.0" | Hostname to bind to |

$3

Wrap a Vercel AI SDK ToolLoopAgent or Model for use with Reminix Runtime. Use this with serve from @reminix/runtime for multi-agent setups.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| modelOrAgent | ToolLoopAgent \| LanguageModel | required | A ToolLoopAgent or language model |
| options.name | string | "vercel-ai-agent" | Name for the agent (used in URL path) |

Returns: VercelAIAgentAdapter - A Reminix adapter instance

Using Different Providers

The Vercel AI SDK supports multiple providers:

`typescript
import { openai } from '@ai-sdk/openai';
import { anthropic } from '@ai-sdk/anthropic';
import { google } from '@ai-sdk/google';
import { wrapAgent } from '@reminix/vercel-ai';
import { serve } from '@reminix/runtime';

const gpt = wrapAgent(openai('gpt-4o'), { name: 'gpt' });
const claude = wrapAgent(anthropic('claude-sonnet-4-20250514'), { name: 'claude' });
const gemini = wrapAgent(google('gemini-pro'), { name: 'gemini' });

serve({ agents: [gpt, claude, gemini], port: 8080 });
`

When to Use Each Option

| Option | Use Case |
|--------|----------|
| ToolLoopAgent | Agents that need tools, multi-step reasoning, automatic tool loop |
| Model | Simple completions, providers without dedicated adapters (Google, Mistral, etc.) |

Endpoint Input/Output Formats

$3

Execute the agent with a prompt or messages.

Request with prompt:
`json
{
"prompt": "Summarize this text: ..."
}
`

Request with messages:
`json
{
"messages": [
{"role": "user", "content": "Hello!"}
]
}
`

Response:
`json
{
"output": "Hello! How can I help you today?"
}
`

$3

For streaming responses, set stream: true in the request:

`json
{
"prompt": "Tell me a story",
"stream": true
}
`

The response will be sent as Server-Sent Events (SSE).

Runtime Documentation

For information about the server, endpoints, request/response formats, and more, see the @reminix/runtime` package.

Deployment

Ready to go live?

- Deploy to Reminix Cloud - Zero-config cloud hosting
- Self-host - Run on your own infrastructure

Links

- GitHub Repository
- Vercel AI SDK Documentation

License

Apache-2.0