openreader/docs-site/docs/configure/tts-provider-guides/kitten-tts-fastapi.md
Richard R 7810a6329a
Some checks failed
Create and publish Docker images / prepare (push) Has been cancelled
Version Docs on Tag / version-docs (push) Has been cancelled
Create and publish Docker images / build (amd64, linux/amd64, ubuntu-24.04) (push) Has been cancelled
Create and publish Docker images / build (arm64, linux/arm64, ubuntu-24.04-arm) (push) Has been cancelled
Create and publish Docker images / merge (push) Has been cancelled
feat: add KittenTTS-FastAPI support and update documentation
2026-02-21 20:19:00 -07:00

1.4 KiB

title
KittenTTS-FastAPI

Use KittenTTS-FastAPI as an OpenAI-compatible TTS backend for OpenReader.

Provider

  • Provider: Custom OpenAI-Like
  • Typical model: kitten-tts
  • API_BASE: required (usually your KittenTTS URL ending with /v1)
  • API_KEY: set only if your deployment requires one

Run KittenTTS (CPU)

docker run -it --rm \
  --name kittentts-fastapi \
  -e KITTEN_MODEL_REPO_ID="KittenML/kitten-tts-nano-0.8-fp32" \
  -p 8005:8005 \
  ghcr.io/richardr1126/kittentts-fastapi-cpu

OpenReader setup

  1. Start your KittenTTS-FastAPI server.
  2. In OpenReader Settings, choose provider Custom OpenAI-Like.
  3. Set API_BASE to your KittenTTS base URL (typically ending with /v1).
  4. Set API_KEY only if your deployment requires one.
  5. Choose model kitten-tts (or another model exposed by your deployment).

Notes

:::info OpenAI-compatible API OpenReader expects OpenAI-compatible audio endpoints when using KittenTTS through Custom OpenAI-Like. :::

:::tip Endpoint shape Use an API_BASE that points at the KittenTTS API root (typically ending with /v1). :::

References