pipecat-rumik 0.1.1__tar.gz

pipecat_rumik-0.1.1/.env.example

@@ -0,0 +1,12 @@
+RUMIK_API_KEY=
+RUMIK_GATEWAY_URL=
+
+RUMIK_MODEL=muga
+RUMIK_SPEAKER_ID=0
+RUMIK_DESCRIPTION=neutral
+RUMIK_TEMPERATURE=0.6
+RUMIK_TOPK=40
+RUMIK_MAX_NEW_TOKENS=2048
+
+RUMIK_SMOKE_TIMEOUT=45
+RUMIK_SUITE_CASES=sequential,concurrent,reconnect

pipecat_rumik-0.1.1/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+.env
+.env.*
+!.env.example
+.pytest_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+*.egg-info/
+*.wav

pipecat_rumik-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rumik AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pipecat_rumik-0.1.1/PKG-INFO

@@ -0,0 +1,284 @@
+Metadata-Version: 2.4
+Name: pipecat-rumik
+Version: 0.1.1
+Summary: Rumik text-to-speech services for Pipecat
+Project-URL: Homepage, https://rumik.ai
+Project-URL: Repository, https://github.com/ira-rumik/pipecat-rumik
+Project-URL: Issues, https://github.com/ira-rumik/pipecat-rumik/issues
+Project-URL: Support, https://github.com/ira-rumik/pipecat-rumik/issues
+Author: Rumik AI
+Maintainer: Rumik AI
+License: MIT License
+        
+        Copyright (c) 2026 Rumik AI
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: pipecat,rumik,speech,text-to-speech,tts,voice-ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: certifi>=2024.2.2
+Requires-Dist: pipecat-ai<2,>=1.0.0
+Requires-Dist: websockets>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pipecat-rumik
+
+Text-to-speech service implementations for
+[Pipecat](https://github.com/pipecat-ai/pipecat) using Rumik's TTS APIs.
+
+## Overview
+
+`pipecat-rumik` provides two Pipecat TTS services:
+
+- `RumikTTSService` for WebSocket-based synthesis in interactive voice
+  pipelines.
+- `RumikHttpTTSService` for HTTP request/response synthesis.
+
+The package follows Pipecat's service conventions: constructor-level provider
+configuration, runtime-configurable `Settings`, raw PCM audio frames, metrics,
+and standard service connection events.
+
+```python
+from pipecat_rumik import RumikHttpTTSService, RumikTTSService, RumikTTSSettings
+```
+
+## Installation
+
+```bash
+pip install pipecat-rumik
+```
+
+For local development:
+
+```bash
+uv sync --extra dev
+```
+
+## Prerequisites
+
+Before using either service, configure access to the Rumik gateway:
+
+```bash
+export RUMIK_API_KEY=...
+export RUMIK_GATEWAY_URL=...
+```
+
+Optional environment variables used by the smoke-test examples:
+
+```bash
+export RUMIK_MODEL=muga
+export RUMIK_SPEAKER_ID=0
+export RUMIK_DESCRIPTION=neutral
+export RUMIK_TEMPERATURE=0.6
+export RUMIK_TOPK=40
+export RUMIK_MAX_NEW_TOKENS=2048
+```
+
+## Service Selection
+
+| Service | Transport | Recommended Use |
+| --- | --- | --- |
+| `RumikTTSService` | WebSocket | Interactive Pipecat voice agents that need interruption-aware TTS. |
+| `RumikHttpTTSService` | HTTP | Simpler synthesis flows where a request/response API is preferred. |
+
+Use the WebSocket service for conversational applications. Use the HTTP service
+for batch-style synthesis or integration tests that do not need a persistent TTS
+connection.
+
+## Configuration
+
+### RumikTTSService
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `api_key` | `str` | yes | Rumik API key. |
+| `gateway_url` | `str` | yes | Rumik gateway base URL. |
+| `settings` | `RumikTTSService.Settings \| None` | no | Runtime-configurable TTS settings. |
+| `sample_rate` | `int \| None` | no | Output sample rate. Rumik currently emits 24 kHz PCM. |
+| `full_response_aggregation` | `bool` | no | Buffer a complete LLM response before sending it to Rumik. Defaults to `True`. |
+
+### RumikHttpTTSService
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `api_key` | `str` | yes | Rumik API key. |
+| `gateway_url` | `str` | yes | Rumik gateway base URL. |
+| `aiohttp_session` | `aiohttp.ClientSession` | yes | Caller-owned HTTP session. |
+| `settings` | `RumikHttpTTSService.Settings \| None` | no | Runtime-configurable TTS settings. |
+| `sample_rate` | `int \| None` | no | Output sample rate. Rumik currently emits 24 kHz PCM. |
+
+## Settings
+
+Both services use Pipecat's service settings pattern:
+
+```python
+settings=RumikTTSService.Settings(...)
+settings=RumikHttpTTSService.Settings(...)
+```
+
+`RumikTTSService.Settings` and `RumikHttpTTSService.Settings` are aliases of
+`RumikTTSSettings`.
+
+| Setting | Type | Default | Used By | Description |
+| --- | --- | --- | --- | --- |
+| `model` | `str \| None` | `"muga"` | HTTP, WS | Rumik model identifier. |
+| `voice` | `str \| None` | `None` | inherited | Reserved for Pipecat provider compatibility. |
+| `language` | `Language \| str \| None` | `None` | inherited | Reserved for Pipecat provider compatibility. |
+| `speaker_id` | `int` | `0` | WS | Rumik WebSocket speaker ID. |
+| `description` | `str \| None` | `"neutral"` | HTTP | Voice/style description. |
+| `temperature` | `float \| None` | `0.6` | HTTP | Sampling temperature. |
+| `topk` | `int \| None` | `40` | HTTP | Top-k sampling. |
+| `max_new_tokens` | `int \| None` | `2048` | HTTP | Maximum generated audio tokens. |
+
+Runtime updates use Pipecat's `TTSUpdateSettingsFrame` with
+`RumikTTSSettings`.
+
+## Usage
+
+### WebSocket Service
+
+```python
+import os
+
+from pipecat_rumik import RumikTTSService
+
+tts = RumikTTSService(
+    api_key=os.environ["RUMIK_API_KEY"],
+    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+    settings=RumikTTSService.Settings(
+        model="muga",
+        speaker_id=0,
+    ),
+)
+```
+
+By default, `RumikTTSService` uses full-response aggregation. This sends one
+complete assistant response to Rumik instead of creating a separate TTS request
+for every sentence.
+
+```python
+tts = RumikTTSService(
+    api_key=os.environ["RUMIK_API_KEY"],
+    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+    full_response_aggregation=False,
+)
+```
+
+### HTTP Service
+
+```python
+import os
+
+import aiohttp
+
+from pipecat_rumik import RumikHttpTTSService
+
+async with aiohttp.ClientSession() as session:
+    tts = RumikHttpTTSService(
+        api_key=os.environ["RUMIK_API_KEY"],
+        gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+        aiohttp_session=session,
+        settings=RumikHttpTTSService.Settings(
+            model="muga",
+            description="neutral",
+            temperature=0.6,
+            topk=40,
+            max_new_tokens=2048,
+        ),
+    )
+```
+
+The HTTP service uses the caller-owned `aiohttp.ClientSession`. Create and close
+the session in your application code.
+
+## Notes
+
+- **WebSocket vs HTTP**: The WebSocket service is intended for interactive
+  Pipecat conversations. The HTTP service is useful for simpler batch-style
+  synthesis.
+- **Request lifecycle**: The WebSocket service keeps one active synthesis
+  request per connection so audio chunks are routed deterministically to the
+  active Pipecat audio context.
+- **Interruption handling**: On interruption, the WebSocket service closes the
+  active socket and opens a fresh session before accepting the next synthesis
+  request.
+- **Audio format**: Rumik currently emits 24 kHz, mono, signed 16-bit PCM. The
+  services validate provider responses against this audio contract before
+  emitting Pipecat audio frames.
+- **HTTP response handling**: The HTTP service validates the WAV response,
+  removes the WAV container, and emits raw PCM frames.
+
+## Event Handlers
+
+`RumikTTSService` supports Pipecat's standard service connection events:
+
+| Event | Description |
+| --- | --- |
+| `on_connected` | Connected to the Rumik WebSocket service. |
+| `on_disconnected` | Disconnected from the Rumik WebSocket service. |
+| `on_connection_error` | WebSocket connection error occurred. |
+
+```python
+@tts.event_handler("on_connected")
+async def on_connected(service):
+    print("Connected to Rumik")
+```
+
+## Examples
+
+The repository includes manual smoke tests:
+
+```bash
+env PYTHONPATH=src uv run python examples/smoke_rumik_http.py
+env PYTHONPATH=src uv run python examples/smoke_rumik_ws.py
+env PYTHONPATH=src uv run python examples/smoke_rumik_ws_suite.py
+```
+
+The smoke tests require real Rumik credentials. Unit tests do not.
+
+## Testing
+
+Offline checks:
+
+```bash
+uv run --locked pytest -q
+uv run --locked ruff check src tests examples scripts
+uv run --locked python -m compileall -q src tests examples scripts
+uv build
+uv run --with twine twine check dist/*
+```
+
+See [TESTING.md](TESTING.md) for the full test checklist and
+[RELEASE.md](RELEASE.md) for TestPyPI/PyPI release steps.
+
+## License
+
+This package is released under the MIT License. See [LICENSE](LICENSE).

pipecat_rumik-0.1.1/README.md

@@ -0,0 +1,233 @@
+# pipecat-rumik
+
+Text-to-speech service implementations for
+[Pipecat](https://github.com/pipecat-ai/pipecat) using Rumik's TTS APIs.
+
+## Overview
+
+`pipecat-rumik` provides two Pipecat TTS services:
+
+- `RumikTTSService` for WebSocket-based synthesis in interactive voice
+  pipelines.
+- `RumikHttpTTSService` for HTTP request/response synthesis.
+
+The package follows Pipecat's service conventions: constructor-level provider
+configuration, runtime-configurable `Settings`, raw PCM audio frames, metrics,
+and standard service connection events.
+
+```python
+from pipecat_rumik import RumikHttpTTSService, RumikTTSService, RumikTTSSettings
+```
+
+## Installation
+
+```bash
+pip install pipecat-rumik
+```
+
+For local development:
+
+```bash
+uv sync --extra dev
+```
+
+## Prerequisites
+
+Before using either service, configure access to the Rumik gateway:
+
+```bash
+export RUMIK_API_KEY=...
+export RUMIK_GATEWAY_URL=...
+```
+
+Optional environment variables used by the smoke-test examples:
+
+```bash
+export RUMIK_MODEL=muga
+export RUMIK_SPEAKER_ID=0
+export RUMIK_DESCRIPTION=neutral
+export RUMIK_TEMPERATURE=0.6
+export RUMIK_TOPK=40
+export RUMIK_MAX_NEW_TOKENS=2048
+```
+
+## Service Selection
+
+| Service | Transport | Recommended Use |
+| --- | --- | --- |
+| `RumikTTSService` | WebSocket | Interactive Pipecat voice agents that need interruption-aware TTS. |
+| `RumikHttpTTSService` | HTTP | Simpler synthesis flows where a request/response API is preferred. |
+
+Use the WebSocket service for conversational applications. Use the HTTP service
+for batch-style synthesis or integration tests that do not need a persistent TTS
+connection.
+
+## Configuration
+
+### RumikTTSService
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `api_key` | `str` | yes | Rumik API key. |
+| `gateway_url` | `str` | yes | Rumik gateway base URL. |
+| `settings` | `RumikTTSService.Settings \| None` | no | Runtime-configurable TTS settings. |
+| `sample_rate` | `int \| None` | no | Output sample rate. Rumik currently emits 24 kHz PCM. |
+| `full_response_aggregation` | `bool` | no | Buffer a complete LLM response before sending it to Rumik. Defaults to `True`. |
+
+### RumikHttpTTSService
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `api_key` | `str` | yes | Rumik API key. |
+| `gateway_url` | `str` | yes | Rumik gateway base URL. |
+| `aiohttp_session` | `aiohttp.ClientSession` | yes | Caller-owned HTTP session. |
+| `settings` | `RumikHttpTTSService.Settings \| None` | no | Runtime-configurable TTS settings. |
+| `sample_rate` | `int \| None` | no | Output sample rate. Rumik currently emits 24 kHz PCM. |
+
+## Settings
+
+Both services use Pipecat's service settings pattern:
+
+```python
+settings=RumikTTSService.Settings(...)
+settings=RumikHttpTTSService.Settings(...)
+```
+
+`RumikTTSService.Settings` and `RumikHttpTTSService.Settings` are aliases of
+`RumikTTSSettings`.
+
+| Setting | Type | Default | Used By | Description |
+| --- | --- | --- | --- | --- |
+| `model` | `str \| None` | `"muga"` | HTTP, WS | Rumik model identifier. |
+| `voice` | `str \| None` | `None` | inherited | Reserved for Pipecat provider compatibility. |
+| `language` | `Language \| str \| None` | `None` | inherited | Reserved for Pipecat provider compatibility. |
+| `speaker_id` | `int` | `0` | WS | Rumik WebSocket speaker ID. |
+| `description` | `str \| None` | `"neutral"` | HTTP | Voice/style description. |
+| `temperature` | `float \| None` | `0.6` | HTTP | Sampling temperature. |
+| `topk` | `int \| None` | `40` | HTTP | Top-k sampling. |
+| `max_new_tokens` | `int \| None` | `2048` | HTTP | Maximum generated audio tokens. |
+
+Runtime updates use Pipecat's `TTSUpdateSettingsFrame` with
+`RumikTTSSettings`.
+
+## Usage
+
+### WebSocket Service
+
+```python
+import os
+
+from pipecat_rumik import RumikTTSService
+
+tts = RumikTTSService(
+    api_key=os.environ["RUMIK_API_KEY"],
+    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+    settings=RumikTTSService.Settings(
+        model="muga",
+        speaker_id=0,
+    ),
+)
+```
+
+By default, `RumikTTSService` uses full-response aggregation. This sends one
+complete assistant response to Rumik instead of creating a separate TTS request
+for every sentence.
+
+```python
+tts = RumikTTSService(
+    api_key=os.environ["RUMIK_API_KEY"],
+    gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+    full_response_aggregation=False,
+)
+```
+
+### HTTP Service
+
+```python
+import os
+
+import aiohttp
+
+from pipecat_rumik import RumikHttpTTSService
+
+async with aiohttp.ClientSession() as session:
+    tts = RumikHttpTTSService(
+        api_key=os.environ["RUMIK_API_KEY"],
+        gateway_url=os.environ["RUMIK_GATEWAY_URL"],
+        aiohttp_session=session,
+        settings=RumikHttpTTSService.Settings(
+            model="muga",
+            description="neutral",
+            temperature=0.6,
+            topk=40,
+            max_new_tokens=2048,
+        ),
+    )
+```
+
+The HTTP service uses the caller-owned `aiohttp.ClientSession`. Create and close
+the session in your application code.
+
+## Notes
+
+- **WebSocket vs HTTP**: The WebSocket service is intended for interactive
+  Pipecat conversations. The HTTP service is useful for simpler batch-style
+  synthesis.
+- **Request lifecycle**: The WebSocket service keeps one active synthesis
+  request per connection so audio chunks are routed deterministically to the
+  active Pipecat audio context.
+- **Interruption handling**: On interruption, the WebSocket service closes the
+  active socket and opens a fresh session before accepting the next synthesis
+  request.
+- **Audio format**: Rumik currently emits 24 kHz, mono, signed 16-bit PCM. The
+  services validate provider responses against this audio contract before
+  emitting Pipecat audio frames.
+- **HTTP response handling**: The HTTP service validates the WAV response,
+  removes the WAV container, and emits raw PCM frames.
+
+## Event Handlers
+
+`RumikTTSService` supports Pipecat's standard service connection events:
+
+| Event | Description |
+| --- | --- |
+| `on_connected` | Connected to the Rumik WebSocket service. |
+| `on_disconnected` | Disconnected from the Rumik WebSocket service. |
+| `on_connection_error` | WebSocket connection error occurred. |
+
+```python
+@tts.event_handler("on_connected")
+async def on_connected(service):
+    print("Connected to Rumik")
+```
+
+## Examples
+
+The repository includes manual smoke tests:
+
+```bash
+env PYTHONPATH=src uv run python examples/smoke_rumik_http.py
+env PYTHONPATH=src uv run python examples/smoke_rumik_ws.py
+env PYTHONPATH=src uv run python examples/smoke_rumik_ws_suite.py
+```
+
+The smoke tests require real Rumik credentials. Unit tests do not.
+
+## Testing
+
+Offline checks:
+
+```bash
+uv run --locked pytest -q
+uv run --locked ruff check src tests examples scripts
+uv run --locked python -m compileall -q src tests examples scripts
+uv build
+uv run --with twine twine check dist/*
+```
+
+See [TESTING.md](TESTING.md) for the full test checklist and
+[RELEASE.md](RELEASE.md) for TestPyPI/PyPI release steps.
+
+## License
+
+This package is released under the MIT License. See [LICENSE](LICENSE).

pipecat_rumik-0.1.1/RELEASE.md

@@ -0,0 +1,136 @@
+# Releasing pipecat-rumik
+
+Use this checklist for TestPyPI and PyPI releases. Do not commit API tokens,
+`.pypirc`, generated `dist/` artifacts, or smoke-test audio files.
+
+## Prerequisites
+
+- `main` is clean and pushed.
+- GitHub Actions is green on the commit being released.
+- The repository is public-ready: no secrets, local paths, private app names, or
+  internal migration notes in the tracked tree.
+- Before making a previously private repository public, delete old workflow
+  runs/logs or publish from a fresh public repository created from the clean
+  tree.
+- Live HTTP, WebSocket, and interactive interruption tests have been run.
+- A TestPyPI account exists.
+- A PyPI account exists before the real release.
+
+For a new package, the first TestPyPI upload usually needs an account-level API
+token because the project does not exist yet. After the first upload, prefer a
+project-scoped token.
+
+## Build and Check
+
+Build from a clean checkout:
+
+```bash
+git status --short --branch
+rm -rf dist
+uv build
+uv run --with twine twine check dist/*
+```
+
+Inspect package contents:
+
+```bash
+tar -tzf dist/*.tar.gz | sort
+python -m zipfile -l dist/*.whl
+```
+
+Expected result:
+
+- `LICENSE`, `README.md`, `pyproject.toml`, `src/pipecat_rumik`, examples, and
+  tests are present in the source distribution.
+- The wheel contains only the importable package and `.dist-info` metadata.
+- `.env`, `.venv`, caches, generated WAV files, and `dist/` contents are absent
+  from the source distribution.
+
+## Upload to TestPyPI
+
+Set the TestPyPI API token in the shell session only:
+
+```bash
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=...
+```
+
+Upload:
+
+```bash
+uv run --with twine twine upload \
+  --repository-url https://test.pypi.org/legacy/ \
+  dist/*
+```
+
+If TestPyPI rejects the upload because the version already exists, bump
+`version` in `pyproject.toml`, rebuild, and upload the new version. Package
+versions are immutable once uploaded.
+
+## Install From TestPyPI
+
+Use a clean environment. The extra PyPI index is required because dependencies
+such as `pipecat-ai` may not exist on TestPyPI.
+
+```bash
+python3 -m venv /tmp/pipecat-rumik-testpypi
+/tmp/pipecat-rumik-testpypi/bin/python -m pip install --upgrade pip
+/tmp/pipecat-rumik-testpypi/bin/python -m pip install \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ \
+  pipecat-rumik==0.1.1
+/tmp/pipecat-rumik-testpypi/bin/python -c "from pipecat_rumik import RumikTTSService, RumikHttpTTSService, RumikTTSSettings; print(RumikTTSService.__name__, RumikHttpTTSService.__name__, RumikTTSSettings.__name__)"
+/tmp/pipecat-rumik-testpypi/bin/python -m pip check
+```
+
+Then run the unit tests against the installed package:
+
+```bash
+/tmp/pipecat-rumik-testpypi/bin/python -m pip install pytest
+/tmp/pipecat-rumik-testpypi/bin/python -m unittest discover -s tests
+```
+
+## Upload to PyPI
+
+Only do this after TestPyPI install verification and live provider testing pass.
+
+Set the real PyPI API token in the shell session only:
+
+```bash
+export TWINE_USERNAME=__token__
+export TWINE_PASSWORD=...
+```
+
+Upload:
+
+```bash
+uv run --with twine twine upload dist/*
+```
+
+Verify from a fresh environment:
+
+```bash
+python3 -m venv /tmp/pipecat-rumik-pypi
+/tmp/pipecat-rumik-pypi/bin/python -m pip install --upgrade pip
+/tmp/pipecat-rumik-pypi/bin/python -m pip install pipecat-rumik==0.1.1
+/tmp/pipecat-rumik-pypi/bin/python -c "from pipecat_rumik import RumikTTSService; print(RumikTTSService.__name__)"
+/tmp/pipecat-rumik-pypi/bin/python -m pip check
+```
+
+## Tag the Release
+
+After the PyPI package is verified:
+
+```bash
+git tag v0.1.1
+git push origin v0.1.1
+```
+
+If the release fails after uploading to PyPI, do not reuse the same version.
+Bump to a new patch version and release again.
+
+## References
+
+- Python Packaging User Guide: https://packaging.python.org/en/latest/tutorials/packaging-projects/
+- PyPI upload API: https://docs.pypi.org/api/upload/
+- PyPI API token help: https://pypi.org/help/#apitoken