Orpheus-FastAPI

Run Orpheus-FastAPI locally and connect it to OpenReader using the Custom OpenAI-Like provider.

Run Orpheus

Refer to the upstream repository for Docker instructions: Lex-au/Orpheus-FastAPI.

Connect to OpenReader

Recommended (auth + admin): Settings → Admin → Shared providers

1. Add a shared provider with type custom-openai.
2. Set base URL to your Orpheus endpoint (e.g. http://orpheus:8000/v1).
3. Leave API key blank unless required by your deployment.
4. Set default model to Orpheus (or your backend model id).

Legacy bootstrap seed (optional, first boot only):

API_BASE=http://orpheus:8000/v1

Use the container name if that's how it's named, or host.docker.internal if not.

Or in-app via Settings → TTS Provider:

1. Set provider to Custom OpenAI-Like.
2. Set API_BASE to your Orpheus endpoint (e.g. http://orpheus:8000/v1).
3. Leave API_KEY blank unless your deployment requires one.
4. Choose model Orpheus (or the model your deployment exposes).

See TTS Providers for admin-shared vs per-user behavior.

References

• Lex-au/Orpheus-FastAPI
• TTS Providers
• TTS Environment Variables