From 171692aa30762710297faee3f68711bfb91ec042 Mon Sep 17 00:00:00 2001 From: Mark Backman Date: Sun, 29 Mar 2026 12:39:13 -0400 Subject: [PATCH] Add pipecat-{vendor} package naming convention to community guide Formalizes the package naming pattern that most community contributors already follow organically, improving discoverability on PyPI. --- COMMUNITY_INTEGRATIONS.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/COMMUNITY_INTEGRATIONS.md b/COMMUNITY_INTEGRATIONS.md index 03d0483b3..ab45171d7 100644 --- a/COMMUNITY_INTEGRATIONS.md +++ b/COMMUNITY_INTEGRATIONS.md @@ -225,6 +225,17 @@ Vision services process images and provide analysis such as descriptions, object ### Naming Conventions +#### Package and Repository Naming + +Use the `pipecat-{vendor}` naming convention for your PyPI package and repository: + +- `pipecat-{vendor}` — for single-service integrations (e.g., `pipecat-deepdub`) +- `pipecat-{vendor}-{type}` — when a vendor offers multiple service types (e.g., `pipecat-upliftai-stt`, `pipecat-upliftai-tts`) + +This convention makes community packages easily discoverable via PyPI search and clearly identifies them as part of the Pipecat ecosystem. + +#### Class Naming + - **STT:** `VendorSTTService` - **LLM:** `VendorLLMService` - **TTS:** @@ -406,8 +417,9 @@ Use Pipecat's tracing decorators: ### Packaging and Distribution +- Name your package `pipecat-{vendor}` (see [Naming Conventions](#naming-conventions)) - Use [uv](https://docs.astral.sh/uv/) for packaging (encouraged) -- Consider releasing to PyPI for easier installation +- Publish to PyPI for easier installation - Follow semantic versioning principles - Maintain a changelog