Skip to content

Fix Pipecat quickstart: correct package extra and service Settings API#232

Open
ArchieMcM234 wants to merge 1 commit intomainfrom
fix/pipecat-package-extras
Open

Fix Pipecat quickstart: correct package extra and service Settings API#232
ArchieMcM234 wants to merge 1 commit intomainfrom
fix/pipecat-package-extras

Conversation

@ArchieMcM234
Copy link
Copy Markdown
Contributor

Two fixes to the Pipecat quickstart docs, caught during dogfooding:

index.mdx

  • Changed pipecat-ai[local-smart-turn-v3,...] → pipecat-ai[local-smart-turn,...]
  • The local-smart-turn-v3 extra doesn't exist in the package, causing an install warning

assets/main.py

  • Updated service initialisation to use the current .Settings() API:
    • SpeechmaticsSTTService: params=InputParams(...) → settings=Settings(...)
    • OpenAILLMService: model="gpt-4o-mini" → settings=Settings(model="gpt-4o-mini")
    • SpeechmaticsTTSService: voice_id="sarah" → settings=Settings(voice="sarah")

Testing

Followed the quickstart end-to-end with these changes:

  • Install: clean, no warnings
  • Bot started successfully and reached Uvicorn running on http://localhost:7860
  • No DeprecationWarnings

…gs API

- Fix requirements.txt: local-smart-turn-v3 → local-smart-turn (extra doesn't exist)
- Update main.py: use .Settings() pattern for STT, LLM, and TTS service init
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 27, 2026 0:32am

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Pipecat quickstart documentation to align with the current pipecat-ai package extras and the newer service initialization APIs, so users can follow the guide without install warnings or outdated parameters.

Changes:

  • Fixes the pipecat-ai extra in the quickstart requirements.txt example (local-smart-turn-v3local-smart-turn).
  • Updates the quickstart main.py example to use each service’s .Settings(...) API instead of deprecated/older constructor arguments.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/integrations-and-sdks/pipecat/index.mdx Updates the quickstart dependency extra to a valid one.
docs/integrations-and-sdks/pipecat/assets/main.py Migrates example service initialization to the Settings(...) configuration style.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


```text title="requirements.txt"
pipecat-ai[local-smart-turn-v3,silero,speechmatics,webrtc,openai,runner]
pipecat-ai[local-smart-turn,silero,speechmatics,webrtc,openai,runner]
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The requirements extra is now local-smart-turn, but the quickstart code uses LocalSmartTurnAnalyzerV3 (from local_smart_turn_v3). This name mismatch can confuse readers about which dependency provides the V3 analyzer. Consider adding a brief note here (or in the setup section) that the local-smart-turn extra includes the V3 analyzer, or adjust the wording to reduce the versioned naming ambiguity.

Copilot uses AI. Check for mistakes.
Comment on lines 37 to 42
stt = SpeechmaticsSTTService(
api_key=os.getenv("SPEECHMATICS_API_KEY"),
params=SpeechmaticsSTTService.InputParams(
settings=SpeechmaticsSTTService.Settings(
turn_detection_mode=SpeechmaticsSTTService.TurnDetectionMode.EXTERNAL,
),
)
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This quickstart switches to the newer settings=...Settings(...) API for STT/LLM/TTS, but the other Pipecat docs/examples in this repo still use the older params=...InputParams(...) / voice_id=... style (e.g., docs/integrations-and-sdks/pipecat/stt.mdx and docs/integrations-and-sdks/pipecat/tts.mdx, plus assets/stt-full-example.py). Consider updating those pages/examples or adding a note about the new API to avoid readers mixing incompatible configuration styles.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants