Skip to content

MoQ agent server example. - #236

Draft
filipi87 wants to merge 1 commit into
mainfrom
filipi/moq_deployment_example
Draft

MoQ agent server example.#236
filipi87 wants to merge 1 commit into
mainfrom
filipi/moq_deployment_example

Conversation

@filipi87

@filipi87 filipi87 commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new moq/agent-server example: an announcement-driven, multi-session voice-agent server built on Pipecat's MoQ (Media over QUIC) transport
  • One long-lived process dials a MoQ relay once, discovers clients via its announcement stream, and spawns a fresh STT → LLM → TTS pipeline per client — no /start control plane and no one-process-per-session hosting
  • Complements (doesn't replace) the standard -t moq single-bot pattern in the main pipecat repo; use this when you need one process serving many concurrent MoQ sessions behind a relay
  • Includes two entry points: bot.py (quickstart, config via CLI flags) and server.py (config fully driven by environment variables, suited to a systemd service or container image co-located with a relay)
  • MOQAgentSession/MOQAgentServer in agent.py are documented as a reference implementation to copy and adapt, not a stable pipecat-ai API, since they reach into protected MOQTransport attributes
  • Adds the example to the top-level README.md example index

requires-python = ">=3.11"
dependencies = [
"python-dotenv",
"pipecat-ai[moq,silero,deepgram,cartesia,openai]>=1.4.0",

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

We should bump this once we release Pipecat supporting MoQ.

@filipi87
filipi87 requested a review from vipyne July 16, 2026 15:10
@filipi87

Copy link
Copy Markdown
Contributor Author

@vipyne, I have extracted all the MoQ agent server examples here, as I believe they shouldn't be part of Pipecat.

However, I'm not sure how to test this. Could you double-check that everything is working?

If you agree with this approach, I'll proceed with removing these classes from Pipecat, as I mentioned here:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant