Obsy

Obsy is an open-source observability platform for AI. See what your AI is really doing with just a few lines of code.

Features

• 🔍 Comprehensive Tracing: Track every AI operation in your application with detailed timing and metadata
• 🤖 Multi-Provider Support: Works seamlessly with OpenAI, Vercel AI SDK, Pinecone, and more
• 📊 Continuous Monitoring: Track performance metrics, costs, and usage patterns throughout your application lifecycle
• 🚀 Easy Integration: Get started with just 3 lines of code
• ⚡ Express.js Middleware: Drop-in middleware for automatic request tracing in Express applications
• 🔄 Stream-Aware: Monitor streaming responses with chunk-by-chunk visibility
• 🧠 RAG Insights: Track and analyze your entire retrieval-augmented generation pipeline
• 📝 Detailed Logging: Capture full context of requests, responses, and metadata for every AI interaction

Installation

npm install @obsy-ai/sdk

Quick Start

Basic OpenAI Integration

import { ObsyClient, obsyExpress } from "@obsy-ai/sdk";
import OpenAI from "openai";

// 1. Create Obsy client
const obsy = new ObsyClient({
  apiKey: "<your-obsy-api-key>",
  projectId: "<your-obsy-project-id>",
});

// 2. Instrument OpenAI client
obsy.instrument(openai);

// 3. Enable tracing for each request
app.use(obsyExpress({ client: obsy }));

Vercel AI SDK Integration

import { ObsyClient, obsyExpress } from "@obsy-ai/sdk";
import { generateText, streamText } from "ai";

// 1. Initialize Obsy client
const obsy = new ObsyClient({
  apiKey: "<your-obsy-api-key>",
  projectId: "<your-obsy-project-id>",
});

// 2. Instrument Vercel AI SDK functions
const { generateText, streamText } = obsy.instrumentVercelAI({
  generateText,
  streamText,
});

// 3. Enable tracing
app.use(obsyExpress({ client: obsy }));

RAG Pipeline Monitoring

import { ObsyClient, obsyExpress } from "@obsy-ai/sdk";
import { Pinecone } from "@pinecone-database/pinecone";
import OpenAI from "openai";

// 1. Initialize Obsy client
const obsy = new ObsyClient({
  apiKey: "<your-obsy-api-key>",
  projectId: "<your-obsy-project-id>",
});

// 2. Instrument multiple clients
obsy.instrument(openai).instrument(pinecone);

// 3. Enable tracing
app.use(obsyExpress({ client: obsy }));

Examples

Check out our comprehensive examples:

• OpenAI Integration
• Vercel AI SDK Integration
• RAG Implementation

License

MIT