Providers

# Core package (required)
npm install ai

# Provider packages (install the ones you need)
npm install @ai-sdk/openai    # For OpenAI models
npm install @ai-sdk/anthropic # For Anthropic models
npm install @ai-sdk/google    # For Google models

OPENAI_API_KEY=sk-your-openai-key

const result = await tracia.runLocal({
  model: 'gpt-4o',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello!' }
  ],
  temperature: 0.7,
  maxOutputTokens: 500
});

const stream = tracia.runLocal({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Write a poem.' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk);
}

ANTHROPIC_API_KEY=sk-ant-your-anthropic-key

const result = await tracia.runLocal({
  model: 'claude-sonnet-4-20250514',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Explain quantum computing.' }
  ],
  temperature: 0.7,
  maxOutputTokens: 1000
});

const stream = tracia.runLocal({
  model: 'claude-sonnet-4-20250514',
  messages: [{ role: 'user', content: 'Write a story.' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk);
}

GOOGLE_API_KEY=your-google-api-key

const result = await tracia.runLocal({
  model: 'gemini-2.0-flash',
  messages: [
    { role: 'user', content: 'What are the benefits of TypeScript?' }
  ],
  temperature: 0.5,
  maxOutputTokens: 800
});

const stream = tracia.runLocal({
  model: 'gemini-2.0-flash',
  messages: [{ role: 'user', content: 'Explain machine learning.' }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk);
}

// Fine-tuned OpenAI model
const result = await tracia.runLocal({
  model: 'ft:gpt-4o:my-org:custom-model:abc123',
  provider: 'openai',
  messages: [{ role: 'user', content: 'Hello!' }]
});

// Use a different API key
const result = await tracia.runLocal({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
  providerApiKey: process.env.OPENAI_API_KEY_SECONDARY
});

import { Tracia, TraciaError, TraciaErrorCode } from 'tracia';

try {
  const result = await tracia.runLocal({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hello!' }]
  });
} catch (error) {
  if (error instanceof TraciaError) {
    switch (error.code) {
      case TraciaErrorCode.MISSING_PROVIDER_SDK:
        // Missing ai package or provider package
        console.error('Install required packages: npm install ai @ai-sdk/openai');
        break;
      case TraciaErrorCode.MISSING_PROVIDER_API_KEY:
        console.error('Set OPENAI_API_KEY environment variable');
        break;
      case TraciaErrorCode.PROVIDER_ERROR:
        console.error('Provider API error:', error.message);
        break;
    }
  }
}