> ## Documentation Index
> Fetch the complete documentation index at: https://daily-main.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Noveum Trace

> Community-maintained observability integration that maps Pipecat pipeline events into Noveum traces and spans

export const CommunityMaintained = ({maintainer, maintainerUrl, repo}) => <Note>
    <strong>Community-maintained integration.</strong> This service is built and
    maintained by{" "}
    <a href={maintainerUrl} target="_blank" rel="noreferrer">
      {maintainer}
    </a>
    . Pipecat does not test or officially support it. Please report issues and
    request changes on the{" "}
    <a href={repo} target="_blank" rel="noreferrer">
      source repository
    </a>
    . Learn more about{" "}
    <a href="/api-reference/server/services/community-integrations">
      community integrations
    </a>
    .
  </Note>;

<CommunityMaintained maintainer="Noveum" maintainerUrl="https://github.com/Noveum" repo="https://github.com/Noveum/noveum-trace" />

## Overview

`NoveumPipecatTracer` is an observability integration that maps Pipecat
pipeline events into [Noveum](https://noveum.ai) traces and spans —
conversation turns, STT, LLM, TTS, tool/function calls, metrics, errors, and
optional audio capture. Traces are viewable in the Noveum dashboard for
debugging, analytics, and evaluation of voice agents.

<CardGroup cols={2}>
  <Card title="Integration Docs" icon="book" href="https://noveum.ai/en/docs/integration-examples/pipecat/overview">
    Noveum Trace documentation for the Pipecat integration
  </Card>

  <Card title="Source Repository" icon="github" href="https://github.com/Noveum/noveum-trace">
    Source code, examples, and issues for the Noveum Trace SDK
  </Card>

  <Card title="PyPI Package" icon="cube" href="https://pypi.org/project/noveum-trace/">
    The `noveum-trace` package on PyPI
  </Card>

  <Card title="Noveum Platform" icon="chart-line" href="https://noveum.ai">
    AI observability and evaluation platform for viewing traces
  </Card>
</CardGroup>

## Installation

This is a community-maintained package distributed separately from `pipecat-ai`:

```bash theme={null}
uv add "noveum-trace[pipecat]"
```

## Prerequisites

You need a Noveum account and API key. Credentials are configured via
`noveum_trace.init()` — the tracer itself does not accept `api_key` or
`project` arguments. Set your API key in the `NOVEUM_API_KEY` environment
variable or pass it to `init()`.

## Usage

Initialize Noveum Trace, then attach the tracer to your pipeline and task
using the two-call API:

```python theme={null}
import os

import noveum_trace
from noveum_trace.integrations.pipecat import NoveumPipecatTracer

noveum_trace.init(
    project="my-voice-agent",
    api_key=os.environ["NOVEUM_API_KEY"],
)

tracer = NoveumPipecatTracer(record_audio=True)

pipeline = tracer.observe_pipeline(Pipeline([...]))
task = await tracer.register_task_handlers(task, transport=transport)
```

Once attached, conversation turns and per-service spans are exported to your
Noveum project as the pipeline runs.

<Note>
  Audio and transcript capture are configurable: `record_audio` controls audio
  upload and `capture_text` controls transcript/text capture. Review these
  settings before using the integration with sensitive data.
</Note>

## Compatibility

Requires `pipecat-ai >= 0.0.108` and Python 3.11+. See the
[source repository](https://github.com/Noveum/noveum-trace) for the latest
tested versions and changelog.