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

# Anannas AI

> LLM service implementation using Anannas AI's unified gateway to 500+ models

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="Anannas-AI" maintainerUrl="https://github.com/Anannas-AI" repo="https://github.com/Anannas-AI/anannas-pipecat-integration" />

## Overview

`AnannasLLMService` provides an OpenAI-compatible interface for accessing
[Anannas AI](https://anannas.ai)'s unified inference gateway, which routes to
500+ models from providers such as OpenAI, Anthropic, Mistral, Gemini, and
DeepSeek through a single API. It extends Pipecat's `OpenAILLMService`, so it
supports streaming responses and function calling.

<CardGroup cols={2}>
  <Card title="Source Repository" icon="github" href="https://github.com/Anannas-AI/anannas-pipecat-integration">
    Source code, examples, and issues for the Anannas AI integration
  </Card>

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

  <Card title="Anannas AI" icon="book" href="https://docs.anannas.ai">
    Documentation and supported models for Anannas AI
  </Card>

  <Card title="API Keys" icon="key" href="https://anannas.ai/dashboard">
    Create and manage your Anannas AI API keys
  </Card>
</CardGroup>

## Installation

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

```bash theme={null}
pip install pipecat-anannas
```

## Prerequisites

### Anannas AI Account Setup

Before using the Anannas AI LLM service, you need:

1. **Anannas AI Account**: Sign up at [Anannas AI](https://anannas.ai/)
2. **API Key**: Create a key from your [dashboard](https://anannas.ai/dashboard)

### Required Environment Variables

* `ANANNAS_API_KEY`: Your Anannas AI API key for authentication

## Configuration

<ParamField path="api_key" type="str" default="None">
  Anannas AI API key. Falls back to the `ANANNAS_API_KEY` environment variable
  if not provided.
</ParamField>

<ParamField path="model" type="str" default="gpt-4o">
  Model identifier to use. Supports any model available through Anannas AI
  (e.g., `"gpt-4o"`, `"claude-3-5-sonnet-20241022"`, `"deepseek-chat"`).
</ParamField>

<ParamField path="base_url" type="str" default="https://api.anannas.ai/v1">
  Base URL for the Anannas AI API.
</ParamField>

<ParamField path="kwargs">
  Additional keyword arguments passed through to the underlying
  `OpenAILLMService`.
</ParamField>

## Usage

```python theme={null}
import os

from pipecat_anannas import AnannasLLMService
from pipecat.pipeline.pipeline import Pipeline
from pipecat.services.deepgram.stt import DeepgramSTTService
from pipecat.services.azure.tts import AzureTTSService

# Create services
stt = DeepgramSTTService(api_key=os.getenv("DEEPGRAM_API_KEY"))
llm = AnannasLLMService(
    api_key=os.getenv("ANANNAS_API_KEY"),
    model="gpt-4o",  # or any supported model
)
tts = AzureTTSService(
    api_key=os.getenv("AZURE_SPEECH_API_KEY"),
    region=os.getenv("AZURE_SPEECH_REGION"),
)

# Build pipeline
pipeline = Pipeline([stt, llm, tts])
```

See the [source
repository](https://github.com/Anannas-AI/anannas-pipecat-integration) for a
complete function calling example.

## Compatibility

Tested with Pipecat v0.0.86+. Check the [source
repository](https://github.com/Anannas-AI/anannas-pipecat-integration) for the
latest tested version and changelog.