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

# Simplismart

> LLM service using Simplismart's OpenAI-compatible Chat Completions API

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="simpli-smart" maintainerUrl="https://github.com/simpli-smart" repo="https://github.com/simpli-smart/pipecat-simplismart" />

## Overview

`SimplismartLLMService` generates chat completions using
[Simplismart](https://simplismart.ai)'s OpenAI-compatible Chat Completions API.
It extends Pipecat's `OpenAILLMService`, so it supports the familiar streaming,
settings, and metrics patterns.

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

  <Card title="Simplismart" icon="book" href="https://simplismart.ai">
    Learn more about Simplismart's inference platform
  </Card>
</CardGroup>

## Installation

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

```bash theme={null}
git clone https://github.com/simpli-smart/pipecat-simplismart.git
cd pipecat-simplismart
uv pip install -e .
```

<Note>
  See the [source
  repository](https://github.com/simpli-smart/pipecat-simplismart) for the
  latest install instructions and any published package details.
</Note>

## Prerequisites

### Simplismart Account Setup

Before using the Simplismart LLM service, you need a Simplismart account and an
API key (a JWT bearer token). See [Simplismart](https://simplismart.ai) to get
started.

### Required Environment Variables

* `SIMPLISMART_API_KEY`: Bearer JWT used to authenticate LLM requests.
* `SIMPLISMART_LLM_URL`: OpenAI-compatible base URL (default
  `https://api.simplismart.live`).

## Configuration

<ParamField path="api_key" type="str" required>
  Simplismart API key (JWT bearer token).
</ParamField>

<ParamField path="base_url" type="str" default="https://api.simplismart.live">
  API base URL (no trailing path; the client appends `/v1/...`).
</ParamField>

<ParamField path="model" type="str" default="None">
  Deprecated convenience override for the model. Prefer setting the model via
  `settings`.
</ParamField>

<ParamField path="settings" type="SimplismartLLMService.Settings" default="None">
  Runtime-updatable LLM settings, merged into the service defaults. The default
  model is `"google/gemma-4-31B-it"`.
</ParamField>

<Note>
  `SimplismartLLMService` extends Pipecat's `OpenAILLMService`, and its
  `Settings` inherit from `BaseOpenAILLMService.Settings`. See the [source
  repository](https://github.com/simpli-smart/pipecat-simplismart) for the
  authoritative, up-to-date list of settings.
</Note>

## Usage

```python theme={null}
from pipecat_simplismart import SimplismartLLMService

llm = SimplismartLLMService(
    api_key="YOUR_KEY",
    base_url="https://api.simplismart.live",
    settings=SimplismartLLMService.Settings(model="google/gemma-4-31B-it"),
)

# ... add llm to your pipeline
```

## Compatibility

Tested with Pipecat v1.1.0 (`pipecat-ai>=0.0.86`). Check the [source
repository](https://github.com/simpli-smart/pipecat-simplismart) for the latest
tested version and changelog.