@albatrossai/albatross-sdk

Official TypeScript/JavaScript SDK for Albatross AI - intelligent content selection, recommendations, and personalization.

Installation

npm install @albatrossai/albatross-sdk

Quick Start

import { Client } from '@albatrossai/albatross-sdk';

const client = new Client('your-api-token', 'your-tenant-id');

// Search
const results = await client.search('query', 'use-case', { limit: 10 });

// Recommendations
const recs = await client.getRecommendations('use-case', {
  user_id: 'user-123',
  limit: 10
});

// Track events
await client.putEvent({
  eventType: 'view',
  payload: { user_id: 'user-123', item_id: 'item-456' }
});

Documentation

📖 Complete API Documentation

The full API reference with detailed examples, type definitions, and method documentation is available in the auto-generated TypeDoc documentation.

Key Features

• 🎯 Content selection & search (text, image, vector)
• 🔮 AI predictions & recommendations
• 📊 Event tracking
• 📦 Catalog management
• 🛡️ Full TypeScript support
• 🔄 Auto-retry with exponential backoff

Development

bun install       # Install dependencies
bun run build     # Build the SDK
bun test          # Run tests
bun run docs      # Generate documentation

License

MIT