speechweave 1.0.0__tar.gz

speechweave-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build ".[dev]"
+
+      - name: Lint
+        run: |
+          ruff check .
+          ruff format --check .
+
+      - name: Test
+        run: pytest
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

speechweave-1.0.0/.gitignore

@@ -0,0 +1,16 @@
+.venv/
+dist/
+build/
+*.egg-info/
+src/*.egg-info/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+coverage/
+.DS_Store
+*.log
+.env*

speechweave-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.21
+    hooks:
+      - id: ruff
+        args: [ --fix ]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [ types-requests ]

speechweave-1.0.0/.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true
+    }
+}

speechweave-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SpeechWeave
+
+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.

speechweave-1.0.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: speechweave
+Version: 1.0.0
+Summary: Official SpeechWeave Python SDK
+Project-URL: Homepage, https://github.com/speechweave/speechweave-python
+Project-URL: Documentation, https://speechweave.com/docs
+Project-URL: Issues, https://github.com/speechweave/speechweave-python/issues
+Author-email: David Rae <david@speechweave.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SpeechWeave Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/speechweave.svg)](https://pypi.org/project/speechweave/)
+[![Python versions](https://img.shields.io/pypi/pyversions/speechweave.svg)](https://pypi.org/project/speechweave/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The native Python SDK for SpeechWeave — background job polling, presigned uploads, and webhook verification. Python 3.10+.
+
+**Docs:** [speechweave.com/docs](https://speechweave.com/docs) · [API reference](https://speechweave.com/docs/api)
+
+## Install
+
+```bash
+pip install speechweave
+```
+
+Set your API key:
+
+```bash
+export SPEECHWEAVE_API_KEY="sk_..."
+```
+
+## Quick start
+
+```python
+from speechweave import SpeechWeave, wait_for_job
+
+client = SpeechWeave()
+
+with open("audio.wav", "rb") as f:
+	job = client.transcribe_file(
+		f,
+		filename="audio.wav",
+		model="core",
+		language="en",
+	)
+
+result = wait_for_job(client, job["id"], timeout_sec=300)
+print(result["transcript"])
+```
+
+For `jobs.create`, URL input, cancel, and other job operations, see the [API reference](https://speechweave.com/docs/api).
+
+## Async
+
+```python
+import asyncio
+from speechweave import AsyncSpeechWeave, async_wait_for_job
+
+async def main():
+	async with AsyncSpeechWeave() as client:
+		with open("audio.wav", "rb") as f:
+			job = await client.transcribe_file(
+				f,
+				filename="audio.wav",
+				model="core",
+			)
+
+		result = await async_wait_for_job(client, job["id"])
+		print(result["transcript"])
+
+asyncio.run(main())
+```
+
+## Webhooks
+
+```python
+from speechweave import verify_webhook
+
+result = verify_webhook(
+	secret=WEBHOOK_SECRET,
+	raw_body=raw_body,
+	signature_header=signature_header,
+)
+```
+
+See the [docs](https://speechweave.com/docs) for a full FastAPI example.
+
+## Errors
+
+```python
+from speechweave import SpeechWeave, SpeechWeaveError
+
+try:
+	client = SpeechWeave(api_key="bad_key")
+	client.get_job("job_123")
+except SpeechWeaveError as e:
+	print(e.status)
+	print(e.code)
+```
+
+## Configuration
+
+- `api_key` — or set `SPEECHWEAVE_API_KEY`
+- `base_url` — defaults to `https://api.speechweave.com/v1`
+- `timeout` — httpx timeout in seconds (default `120`)
+
+## Compatibility & Migration
+
+If you are building a new application, use the native SDK above for full feature support. If you have an existing OpenAI, Deepgram, or AssemblyAI codebase, use the options below to switch with minimal changes.
+
+### Drop-in usage
+
+Convenience helpers if you want OpenAI/Deepgram/AssemblyAI response shapes without adding another package. They use presigned uploads like the native API.
+
+```python
+from speechweave import SpeechWeave
+
+client = SpeechWeave()
+
+with open("clip.mp3", "rb") as f:
+	result = client.audio.transcriptions.create(
+		file=f,
+		filename="clip.mp3",
+		model="core",
+	)
+
+print(result["text"])
+```
+
+More examples: [OpenAI](https://speechweave.com/docs/migration/openai) · [Deepgram](https://speechweave.com/docs/migration/deepgram) · [AssemblyAI](https://speechweave.com/docs/migration/assemblyai)
+
+### Migrating from OpenAI
+
+You don't need this SDK for a quick swap — use the official `openai` package and point it at SpeechWeave:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="sk_live_...",
+    base_url="https://api.speechweave.com/v1",
+)
+
+with open("clip.mp3", "rb") as f:
+    result = client.audio.transcriptions.create(model="core", file=f)
+
+print(result.text)
+```
+
+OpenAI model names like `whisper-1` are aliased to `core` on our backend. See the [OpenAI migration guide](https://speechweave.com/docs/migration/openai).

speechweave-1.0.0/README.md

@@ -0,0 +1,141 @@
+# SpeechWeave Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/speechweave.svg)](https://pypi.org/project/speechweave/)
+[![Python versions](https://img.shields.io/pypi/pyversions/speechweave.svg)](https://pypi.org/project/speechweave/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The native Python SDK for SpeechWeave — background job polling, presigned uploads, and webhook verification. Python 3.10+.
+
+**Docs:** [speechweave.com/docs](https://speechweave.com/docs) · [API reference](https://speechweave.com/docs/api)
+
+## Install
+
+```bash
+pip install speechweave
+```
+
+Set your API key:
+
+```bash
+export SPEECHWEAVE_API_KEY="sk_..."
+```
+
+## Quick start
+
+```python
+from speechweave import SpeechWeave, wait_for_job
+
+client = SpeechWeave()
+
+with open("audio.wav", "rb") as f:
+	job = client.transcribe_file(
+		f,
+		filename="audio.wav",
+		model="core",
+		language="en",
+	)
+
+result = wait_for_job(client, job["id"], timeout_sec=300)
+print(result["transcript"])
+```
+
+For `jobs.create`, URL input, cancel, and other job operations, see the [API reference](https://speechweave.com/docs/api).
+
+## Async
+
+```python
+import asyncio
+from speechweave import AsyncSpeechWeave, async_wait_for_job
+
+async def main():
+	async with AsyncSpeechWeave() as client:
+		with open("audio.wav", "rb") as f:
+			job = await client.transcribe_file(
+				f,
+				filename="audio.wav",
+				model="core",
+			)
+
+		result = await async_wait_for_job(client, job["id"])
+		print(result["transcript"])
+
+asyncio.run(main())
+```
+
+## Webhooks
+
+```python
+from speechweave import verify_webhook
+
+result = verify_webhook(
+	secret=WEBHOOK_SECRET,
+	raw_body=raw_body,
+	signature_header=signature_header,
+)
+```
+
+See the [docs](https://speechweave.com/docs) for a full FastAPI example.
+
+## Errors
+
+```python
+from speechweave import SpeechWeave, SpeechWeaveError
+
+try:
+	client = SpeechWeave(api_key="bad_key")
+	client.get_job("job_123")
+except SpeechWeaveError as e:
+	print(e.status)
+	print(e.code)
+```
+
+## Configuration
+
+- `api_key` — or set `SPEECHWEAVE_API_KEY`
+- `base_url` — defaults to `https://api.speechweave.com/v1`
+- `timeout` — httpx timeout in seconds (default `120`)
+
+## Compatibility & Migration
+
+If you are building a new application, use the native SDK above for full feature support. If you have an existing OpenAI, Deepgram, or AssemblyAI codebase, use the options below to switch with minimal changes.
+
+### Drop-in usage
+
+Convenience helpers if you want OpenAI/Deepgram/AssemblyAI response shapes without adding another package. They use presigned uploads like the native API.
+
+```python
+from speechweave import SpeechWeave
+
+client = SpeechWeave()
+
+with open("clip.mp3", "rb") as f:
+	result = client.audio.transcriptions.create(
+		file=f,
+		filename="clip.mp3",
+		model="core",
+	)
+
+print(result["text"])
+```
+
+More examples: [OpenAI](https://speechweave.com/docs/migration/openai) · [Deepgram](https://speechweave.com/docs/migration/deepgram) · [AssemblyAI](https://speechweave.com/docs/migration/assemblyai)
+
+### Migrating from OpenAI
+
+You don't need this SDK for a quick swap — use the official `openai` package and point it at SpeechWeave:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="sk_live_...",
+    base_url="https://api.speechweave.com/v1",
+)
+
+with open("clip.mp3", "rb") as f:
+    result = client.audio.transcriptions.create(model="core", file=f)
+
+print(result.text)
+```
+
+OpenAI model names like `whisper-1` are aliased to `core` on our backend. See the [OpenAI migration guide](https://speechweave.com/docs/migration/openai).

speechweave-1.0.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "speechweave"
+dynamic = ["version"]
+description = "Official SpeechWeave Python SDK"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "David Rae", email = "david@speechweave.com" }
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "httpx>=0.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "ruff>=0.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/speechweave/speechweave-python"
+Documentation = "https://speechweave.com/docs"
+Issues = "https://github.com/speechweave/speechweave-python/issues"
+
+[tool.hatch.version]
+path = "src/speechweave/version.py"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+# Relax the line length for better readability (default is 88)
+line-length = 120
+
+[tool.ruff.format]
+indent-style = "tab"
+quote-style = "double"

speechweave-1.0.0/src/speechweave/__init__.py

@@ -0,0 +1,65 @@
+from speechweave.version import __version__
+from speechweave.async_client import AsyncSpeechWeaveClient
+from speechweave.client import SpeechWeaveClient
+from speechweave.errors import SpeechWeaveError
+from speechweave.namespaces.assembly_compat import AssemblyTranscripts, AsyncAssemblyTranscripts
+from speechweave.namespaces.deepgram_compat import AsyncDeepgramListen, DeepgramListen
+from speechweave.namespaces.jobs import AsyncJobs, Jobs
+from speechweave.namespaces.openai_compat import AsyncOpenAiAudio, OpenAiAudio
+from speechweave.polling import async_wait_for_job, wait_for_job
+from speechweave.webhooks import verify_webhook
+
+
+class SpeechWeave(SpeechWeaveClient):
+	def __init__(
+		self,
+		*args,
+		**kwargs,
+	):
+
+		super().__init__(
+			*args,
+			**kwargs,
+		)
+		self.audio = OpenAiAudio(self)
+		self.listen = DeepgramListen(self)
+		self.transcripts = AssemblyTranscripts(self)
+		self.jobs = Jobs(self)
+
+
+class AsyncSpeechWeave(AsyncSpeechWeaveClient):
+	def __init__(
+		self,
+		*args,
+		**kwargs,
+	):
+
+		super().__init__(
+			*args,
+			**kwargs,
+		)
+		self.audio = AsyncOpenAiAudio(self)
+		self.listen = AsyncDeepgramListen(self)
+		self.transcripts = AsyncAssemblyTranscripts(self)
+		self.jobs = AsyncJobs(self)
+
+
+__all__ = [
+	"AsyncAssemblyTranscripts",
+	"AsyncDeepgramListen",
+	"AsyncJobs",
+	"AsyncOpenAiAudio",
+	"AsyncSpeechWeave",
+	"AsyncSpeechWeaveClient",
+	"AssemblyTranscripts",
+	"DeepgramListen",
+	"Jobs",
+	"OpenAiAudio",
+	"SpeechWeave",
+	"SpeechWeaveClient",
+	"SpeechWeaveError",
+	"__version__",
+	"async_wait_for_job",
+	"verify_webhook",
+	"wait_for_job",
+]