Open
Conversation
Documents that Pipecat Flows requires a cascade LLM service (STT → LLM → TTS) and is not compatible with realtime speech-to-speech services (Gemini Live, OpenAI Realtime, AWS Nova Sonic, Grok, Inworld, Ultravox). Native S2S support is currently being developed. Closes a Kapa coverage gap where users across English, Russian, and Dutch conversations asked the same question and got only a "not supported" answer with no workaround. - New guide: pipecat-flows/guides/realtime-models.mdx with a compatibility table and a concrete cascade example (Deepgram + Gemini Flash + Cartesia) - Cross-linked from the Flows introduction, the Flows API overview, and each of the 7 S2S service pages so users land on the guide regardless of entry point
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation clarifying that Pipecat Flows currently requires a cascade (STT → LLM → TTS) pipeline and is not compatible with realtime speech-to-speech (S2S) services, plus a central guide page that’s linked from Flows entry points and S2S service docs.
Changes:
- Adds a new Flows guide with an S2S compatibility table and a recommended cascade configuration example.
- Cross-links the new guide from the Flows introduction + Flows API overview.
- Adds a “Not compatible with Pipecat Flows” callout + link to the guide across all S2S service pages.
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| pipecat-flows/introduction.mdx | Adds a callout linking Flows users looking for realtime S2S to the new compatibility guide. |
| pipecat-flows/guides/realtime-models.mdx | New guide explaining incompatibility and recommending a cascade workaround with an example. |
| docs.json | Adds the new guide to the Pipecat Flows → Guides navigation. |
| api-reference/server/services/s2s/aws.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/gemini-live.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/gemini-live-vertex.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/grok.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/inworld.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/openai.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/server/services/s2s/ultravox.mdx | Adds Flows incompatibility callout and links to the new guide. |
| api-reference/pipecat-flows/overview.mdx | Adds a “Realtime (S2S) models” note linking to the new guide. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Addresses Copilot review feedback: readers seeing just the `FlowManager` construction may think setup is complete. Adds the `on_client_connected` event handler that calls `flow_manager.initialize(create_initial_node())`, matching the pattern in the Flows Quickstart.
markbackman
reviewed
Apr 17, 2026
|
|
||
| Any service that extends Pipecat's `LLMService` base class is supported. This includes OpenAI-compatible services like Groq, Together, Cerebras, DeepSeek, and others. | ||
|
|
||
| ### Realtime (S2S) models |
Contributor
There was a problem hiding this comment.
I think we only need this small section in overview. Can you update this PR?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
pipecat-flows/guides/realtime-models.mdxwith a compatibility table and a concrete cascade example (Deepgram STT + Gemini Flash LLM + Cartesia TTS).Closes a Kapa coverage gap where users across English, Russian, and Dutch conversations asked the same question (Flows + Gemini Live / OpenAI Realtime) and only got a "not supported" answer with no workaround.
Test plan
mint devrenders the new guide page without errorsmint broken-linkspasses in CI