Metorial makes it easy to add 600+ integrations to your AI SDK applications in just a couple of lines of code. This guide will walk you through setting up your first project.

Prerequisites

• Node.js 18+ or Bun installed
• A Metorial account with an API key
• An AI SDK-compatible provider (OpenAI, Anthropic, etc.)

Installation

Install the required packages:

npm install ai metorial @metorial/ai-sdk
# or
bun add ai metorial @metorial/ai-sdk

Basic Setup

Here's a minimal example of using Metorial with the AI SDK:

import { metorialAISDK } from '@metorial/ai-sdk';
import { Metorial } from 'metorial';
import { generateText } from 'ai';

// Initialize Metorial
const metorial = new Metorial({
  apiKey: 'your-metorial-api-key'
});

// Create a session with your deployed integrations
await metorial.withProviderSession(
  metorialAISDK,
  { serverDeployments: ['your-deployment-id'] },
  async (session) => {
    const result = await generateText({
      model: yourModel, // Any AI SDK compatible model
      messages: [
        { role: 'user', content: 'Check my calendar for today' }
      ],
      tools: session.tools
    });
    
    console.log(result.text);
  }
);

Next Steps

• Learn how to create your Metorial API key
• Explore available integrations
• Check out deployment management