> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moda.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Moda

> Discovery-first observability for AI agents. Cluster every production conversation, surface emerging intents, close the loop.

## What is Moda?

Moda is observability for AI agents. Add a few lines of code to your existing OpenAI, Anthropic, or framework calls, and Moda automatically clusters every production conversation, detects behavior signals and tool failures, and surfaces the intents your agent has never seen before.

Most agent failures aren't bugs. They're intents you didn't know your users had. Moda finds them first.

<Card title="Get started in 5 minutes" icon="rocket" href="/quickstart" horizontal>
  Install the SDK, add two lines of code, and see your first cluster in the dashboard.
</Card>

## Why use Moda

<Columns cols={2}>
  <Card title="All providers, no code changes" icon="plug">
    Works with OpenAI, Anthropic, AWS Bedrock, OpenRouter, Azure, and Vercel AI SDK. Switch models without touching the integration.
  </Card>

  <Card title="Live taxonomy of intent" icon="layer-group">
    Every conversation is clustered into a hierarchical taxonomy that reorganizes itself as your traffic shifts.
  </Card>

  <Card title="Emergent intent detection" icon="sparkles">
    See the intents your agent has never seen before, ranked by growth, before any of them have a canonical answer.
  </Card>

  <Card title="Built to be called" icon="terminal">
    Same data the dashboard renders is available via the CLI and the Data API.
  </Card>
</Columns>

## How it works

1. **Install the Moda SDK** in your application.
2. **Initialize with your API key.** The SDK captures LLM calls in the background, no manual instrumentation.
3. **View clusters, behaviors, and failures** in the [Moda dashboard](https://app.moda.dev), or query them from your terminal.

<CodeGroup>
  ```bash Python theme={"dark"}
  pip install moda-ai
  ```

  ```bash Node.js theme={"dark"}
  npm install moda-ai
  ```
</CodeGroup>

<CodeGroup>
  ```python Python theme={"dark"}
  import moda
  from openai import OpenAI

  moda.init("YOUR_MODA_API_KEY")

  client = OpenAI(api_key="YOUR_OPENAI_KEY")
  response = client.chat.completions.create(
      model="gpt-4o",
      messages=[{"role": "user", "content": "Hello, how are you?"}]
  )

  moda.flush()
  ```

  ```javascript Node.js theme={"dark"}
  import { Moda } from 'moda-ai';
  import OpenAI from 'openai';

  Moda.init('YOUR_MODA_API_KEY');

  const client = new OpenAI({ apiKey: 'YOUR_OPENAI_KEY' });
  const response = await client.chat.completions.create({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hello, how are you?' }],
  });

  await Moda.flush();
  ```
</CodeGroup>

## Next steps

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Step-by-step guide to your first integration.
  </Card>

  <Card title="Ingestion options" icon="upload" href="/ingestion/overview">
    All the ways to send data to Moda.
  </Card>

  <Card title="Data API + CLI" icon="terminal" href="/data-api/overview">
    Query every cluster, behavior signal, and failure from your terminal or your CI.
  </Card>

  <Card title="Use cases" icon="lightbulb" href="/data-api/use-cases">
    What teams build on top of the Moda Data API.
  </Card>
</Columns>
