sayna-client 0.0.1__tar.gz

sayna_client-0.0.1/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: sayna-client
+Version: 0.0.1
+Summary: Python SDK for Sayna server-side WebSocket connections
+Author: Sayna Team
+License: MIT
+Project-URL: Homepage, https://github.com/sayna/saysdk
+Project-URL: Repository, https://github.com/sayna/saysdk
+Project-URL: Documentation, https://github.com/sayna/saysdk/tree/main/python-sdk
+Project-URL: Issues, https://github.com/sayna/saysdk/issues
+Keywords: sayna,websocket,sdk,server,real-time
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Communications
+Classifier: Framework :: AsyncIO
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+
+# Sayna Python SDK
+
+Python SDK for Sayna server-side WebSocket connections, enabling real-time voice interactions with speech-to-text (STT) and text-to-speech (TTS) capabilities.
+
+## Features
+
+- 🎤 **Speech-to-Text**: Real-time transcription with support for multiple providers (Deepgram, Google, etc.)
+- 🔊 **Text-to-Speech**: High-quality voice synthesis with various TTS providers (ElevenLabs, Google, etc.)
+- 🔌 **WebSocket Connection**: Async/await support with aiohttp
+- ✅ **Type Safety**: Full type hints with Pydantic models
+- 🚀 **Easy to Use**: Simple, intuitive API
+- 📦 **Modern Python**: Built for Python 3.9+
+
+## Installation
+
+### Using pip
+
+```bash
+pip install sayna-client
+```
+
+### Using uv (recommended for faster installation)
+
+```bash
+uv pip install sayna-client
+```
+
+### From source
+
+```bash
+git clone https://github.com/sayna/saysdk.git
+cd saysdk/python-sdk
+pip install -e .
+```
+
+## Development Setup
+
+This project supports both traditional pip and modern uv package managers.
+
+### Option 1: Traditional Setup with pip
+
+```bash
+# Create a virtual environment
+python -m venv .venv
+
+# Activate the virtual environment
+# On Linux/macOS:
+source .venv/bin/activate
+# On Windows:
+# .venv\Scripts\activate
+
+# Install development dependencies
+pip install -e ".[dev]"
+```
+
+### Option 2: Modern Setup with uv (Faster)
+
+```bash
+# Install uv if you haven't already
+pip install uv
+
+# Create a virtual environment with uv
+uv venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On Linux/macOS
+# .venv\Scripts\activate on Windows
+
+# Install development dependencies with uv
+uv pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from sayna_client import SaynaClient, STTConfig, TTSConfig
+
+async def main():
+    # Initialize the client
+    client = SaynaClient(
+        url="wss://api.sayna.com/ws",
+        api_key="your-api-key"
+    )
+
+    # Configure STT and TTS
+    stt_config = STTConfig(
+        provider="deepgram",
+        language="en-US",
+        sample_rate=16000,
+        channels=1,
+        punctuation=True,
+        encoding="linear16",
+        model="nova-2"
+    )
+
+    tts_config = TTSConfig(
+        provider="elevenlabs",
+        voice_id="your-voice-id",
+        speaking_rate=1.0,
+        audio_format="mp3",
+        sample_rate=24000,
+        connection_timeout=5000,
+        request_timeout=10000,
+        model="eleven_multilingual_v2",
+        pronunciations=[]
+    )
+
+    # Connect to Sayna
+    await client.connect()
+
+    # Your application logic here
+
+    # Disconnect when done
+    await client.disconnect()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=sayna_client --cov-report=html
+
+# Run specific test file
+pytest tests/test_client.py
+```
+
+### Type Checking
+
+```bash
+mypy src/sayna_client
+```
+
+### Linting and Formatting
+
+This project uses [Ruff](https://github.com/astral-sh/ruff) for linting and formatting:
+
+```bash
+# Check code
+ruff check .
+
+# Format code
+ruff format .
+
+# Fix auto-fixable issues
+ruff check --fix .
+```
+
+### Project Structure
+
+```
+python-sdk/
+├── src/
+│   └── sayna_client/          # Main package
+│       ├── __init__.py        # Package exports
+│       ├── client.py          # SaynaClient implementation
+│       ├── types.py           # Pydantic models
+│       ├── errors.py          # Custom exceptions
+│       └── py.typed           # PEP 561 marker
+├── tests/                     # Test suite
+├── examples/                  # Usage examples
+├── pyproject.toml            # Package configuration
+├── requirements.txt          # Runtime dependencies
+├── requirements-dev.txt      # Development dependencies
+└── README.md                 # This file
+```
+
+## Requirements
+
+- Python 3.9 or higher
+- aiohttp >= 3.9.0
+- pydantic >= 2.0.0
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please visit the [GitHub Issues](https://github.com/sayna/saysdk/issues) page.

sayna_client-0.0.1/README.md

@@ -0,0 +1,192 @@
+# Sayna Python SDK
+
+Python SDK for Sayna server-side WebSocket connections, enabling real-time voice interactions with speech-to-text (STT) and text-to-speech (TTS) capabilities.
+
+## Features
+
+- 🎤 **Speech-to-Text**: Real-time transcription with support for multiple providers (Deepgram, Google, etc.)
+- 🔊 **Text-to-Speech**: High-quality voice synthesis with various TTS providers (ElevenLabs, Google, etc.)
+- 🔌 **WebSocket Connection**: Async/await support with aiohttp
+- ✅ **Type Safety**: Full type hints with Pydantic models
+- 🚀 **Easy to Use**: Simple, intuitive API
+- 📦 **Modern Python**: Built for Python 3.9+
+
+## Installation
+
+### Using pip
+
+```bash
+pip install sayna-client
+```
+
+### Using uv (recommended for faster installation)
+
+```bash
+uv pip install sayna-client
+```
+
+### From source
+
+```bash
+git clone https://github.com/sayna/saysdk.git
+cd saysdk/python-sdk
+pip install -e .
+```
+
+## Development Setup
+
+This project supports both traditional pip and modern uv package managers.
+
+### Option 1: Traditional Setup with pip
+
+```bash
+# Create a virtual environment
+python -m venv .venv
+
+# Activate the virtual environment
+# On Linux/macOS:
+source .venv/bin/activate
+# On Windows:
+# .venv\Scripts\activate
+
+# Install development dependencies
+pip install -e ".[dev]"
+```
+
+### Option 2: Modern Setup with uv (Faster)
+
+```bash
+# Install uv if you haven't already
+pip install uv
+
+# Create a virtual environment with uv
+uv venv
+
+# Activate the virtual environment
+source .venv/bin/activate  # On Linux/macOS
+# .venv\Scripts\activate on Windows
+
+# Install development dependencies with uv
+uv pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from sayna_client import SaynaClient, STTConfig, TTSConfig
+
+async def main():
+    # Initialize the client
+    client = SaynaClient(
+        url="wss://api.sayna.com/ws",
+        api_key="your-api-key"
+    )
+
+    # Configure STT and TTS
+    stt_config = STTConfig(
+        provider="deepgram",
+        language="en-US",
+        sample_rate=16000,
+        channels=1,
+        punctuation=True,
+        encoding="linear16",
+        model="nova-2"
+    )
+
+    tts_config = TTSConfig(
+        provider="elevenlabs",
+        voice_id="your-voice-id",
+        speaking_rate=1.0,
+        audio_format="mp3",
+        sample_rate=24000,
+        connection_timeout=5000,
+        request_timeout=10000,
+        model="eleven_multilingual_v2",
+        pronunciations=[]
+    )
+
+    # Connect to Sayna
+    await client.connect()
+
+    # Your application logic here
+
+    # Disconnect when done
+    await client.disconnect()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=sayna_client --cov-report=html
+
+# Run specific test file
+pytest tests/test_client.py
+```
+
+### Type Checking
+
+```bash
+mypy src/sayna_client
+```
+
+### Linting and Formatting
+
+This project uses [Ruff](https://github.com/astral-sh/ruff) for linting and formatting:
+
+```bash
+# Check code
+ruff check .
+
+# Format code
+ruff format .
+
+# Fix auto-fixable issues
+ruff check --fix .
+```
+
+### Project Structure
+
+```
+python-sdk/
+├── src/
+│   └── sayna_client/          # Main package
+│       ├── __init__.py        # Package exports
+│       ├── client.py          # SaynaClient implementation
+│       ├── types.py           # Pydantic models
+│       ├── errors.py          # Custom exceptions
+│       └── py.typed           # PEP 561 marker
+├── tests/                     # Test suite
+├── examples/                  # Usage examples
+├── pyproject.toml            # Package configuration
+├── requirements.txt          # Runtime dependencies
+├── requirements-dev.txt      # Development dependencies
+└── README.md                 # This file
+```
+
+## Requirements
+
+- Python 3.9 or higher
+- aiohttp >= 3.9.0
+- pydantic >= 2.0.0
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please visit the [GitHub Issues](https://github.com/sayna/saysdk/issues) page.

sayna_client-0.0.1/pyproject.toml

@@ -0,0 +1,149 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sayna-client"
+version = "0.0.1"
+description = "Python SDK for Sayna server-side WebSocket connections"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [
+    {name = "Sayna Team"}
+]
+keywords = ["sayna", "websocket", "sdk", "server", "real-time"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Communications",
+    "Framework :: AsyncIO",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "aiohttp>=3.9.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "mypy>=1.8.0",
+    "ruff>=0.6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sayna/saysdk"
+Repository = "https://github.com/sayna/saysdk"
+Documentation = "https://github.com/sayna/saysdk/tree/main/python-sdk"
+Issues = "https://github.com/sayna/saysdk/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["sayna_client*"]
+
+[tool.setuptools.package-data]
+sayna_client = ["py.typed"]
+
+# Ruff configuration - Modern Python linter and formatter
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+    "TCH",    # flake8-type-checking
+    "PL",     # pylint
+    "RUF",    # ruff-specific rules
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "PLR0913", # too many arguments
+    "PLR2004", # magic value used in comparison
+    "RUF022", # __all__ is not sorted (we use semantic grouping)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["ARG", "PLR2004"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["sayna_client"]
+
+# MyPy configuration - Static type checker
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_generics = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+
+# Pytest configuration
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=sayna_client",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+
+# Coverage configuration
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "*/tests/*",
+    "*/examples/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]

sayna_client-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sayna_client-0.0.1/src/sayna_client/__init__.py

@@ -0,0 +1,74 @@
+"""Sayna Python SDK for server-side WebSocket connections."""
+
+from sayna_client.client import SaynaClient
+from sayna_client.errors import (
+    SaynaConnectionError,
+    SaynaError,
+    SaynaNotConnectedError,
+    SaynaNotReadyError,
+    SaynaServerError,
+    SaynaValidationError,
+)
+from sayna_client.types import (
+    ClearMessage,
+    ConfigMessage,
+    ErrorMessage,
+    HealthResponse,
+    LiveKitConfig,
+    LiveKitTokenRequest,
+    LiveKitTokenResponse,
+    MessageMessage,
+    OutgoingMessage,
+    Participant,
+    ParticipantDisconnectedMessage,
+    Pronunciation,
+    ReadyMessage,
+    SaynaMessage,
+    SendMessageMessage,
+    SpeakMessage,
+    SpeakRequest,
+    STTConfig,
+    STTResultMessage,
+    TTSConfig,
+    TTSPlaybackCompleteMessage,
+    VoiceDescriptor,
+)
+
+__version__ = "0.0.1"
+
+__all__ = [
+    # Client
+    "SaynaClient",
+    # Errors
+    "SaynaError",
+    "SaynaNotConnectedError",
+    "SaynaNotReadyError",
+    "SaynaConnectionError",
+    "SaynaValidationError",
+    "SaynaServerError",
+    # Configuration Types
+    "STTConfig",
+    "TTSConfig",
+    "LiveKitConfig",
+    "Pronunciation",
+    # WebSocket Message Types
+    "ConfigMessage",
+    "SpeakMessage",
+    "ClearMessage",
+    "SendMessageMessage",
+    "ReadyMessage",
+    "STTResultMessage",
+    "ErrorMessage",
+    "SaynaMessage",
+    "MessageMessage",
+    "Participant",
+    "ParticipantDisconnectedMessage",
+    "TTSPlaybackCompleteMessage",
+    "OutgoingMessage",
+    # REST API Types
+    "HealthResponse",
+    "VoiceDescriptor",
+    "LiveKitTokenRequest",
+    "LiveKitTokenResponse",
+    "SpeakRequest",
+]