# Canary — AI Agent Observability

> Your agents are running. Are they safe?

Canary is a real-time observability platform for AI agents in production. It captures traces, monitors health, detects anomalies, and alerts before failures become outages.

## What It Does
- Wraps any async agent function to capture traces (input, output, duration, errors, token usage)
- Provides a dashboard to view and analyze agent behavior in production
- Detects anomalies: latency spikes, error rate changes, output drift
- Alerts via webhook, email, or Slack when agents misbehave

## SDK Installation
```bash
npm install @heycanary/sdk
```

## Quick Start
```typescript
import { init, wrap } from '@heycanary/sdk';

init({ apiKey: 'cnry_...', projectId: 'my-app' });

const agent = wrap(async (prompt: string) => {
  return await openai.chat.completions.create({
    model: 'gpt-4',
    messages: [{ role: 'user', content: prompt }]
  });
}, { name: 'my-agent' });

const result = await agent('Hello world');
// Trace automatically captured and sent to Canary
```

## Key Facts
- Zero dependencies, < 5KB minified
- Non-blocking — never slows down your agents
- TypeScript-first with full generics
- Works with any AI provider (OpenAI, Anthropic, Google, etc.)
- Self-hosted or cloud dashboard

## Links
- Website: https://heycanary.ai
- Documentation: https://heycanary.ai/docs
- GitHub: https://github.com/karthvp/canary-sdk
- npm: https://www.npmjs.com/package/@heycanary/sdk

## Company
Built by Athena Made (https://athenamade.co) — an AI product studio.

## Contact
hello@athenamade.co