diffio 0.1.0__tar.gz

diffio-0.1.0/LICENSE

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

diffio-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: diffio
+Version: 0.1.0
+Summary: Python SDK for the Diffio API.
+Author: Diffio
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# Diffio Python SDK
+
+The Diffio Python SDK helps you call the Diffio API from Python. This version covers project creation, upload, generation, progress checks, and download URLs.
+Requires Python 3.8 or later.
+
+## Install
+
+```bash
+pip install diffio
+```
+
+For local development:
+
+```bash
+cd diffio-python
+pip install -e .
+```
+
+## Configuration
+
+Set the API key with `DIFFIO_API_KEY`. You can also override the base URL with `DIFFIO_API_BASE_URL`.
+
+```bash
+export DIFFIO_API_KEY="diffio_live_..."
+export DIFFIO_API_BASE_URL="https://us-central1-diffioai.cloudfunctions.net"
+```
+
+For emulators, set the base URL to the Functions emulator host.
+
+```bash
+export DIFFIO_API_BASE_URL="http://127.0.0.1:5001/diffioai/us-central1"
+```
+
+## Request options
+
+Use request options to override headers, timeouts, retries, or the API key per request.
+You can also pass `timeoutInSeconds` as an alias for `timeout`.
+
+```py
+from diffio import DiffioClient, RequestOptions
+
+client = DiffioClient(apiKey="diffio_live_...")
+projects = client.list_projects(
+    requestOptions=RequestOptions(
+        headers={"X-Debug": "1"},
+        timeout=30.0,
+        maxRetries=2,
+        retryBackoff=0.5,
+    )
+)
+```
+
+## Create a project and generation
+
+`create_project` uploads the file and returns the project metadata.
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+file_path = "sample.wav"
+project = client.create_project(
+    filePath=file_path,
+)
+
+generation = client.create_generation(
+    apiProjectId=project.apiProjectId,
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+)
+
+print(generation.generationId)
+```
+
+## Audio isolation helper
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+result = client.audio_isolation.isolate(
+    filePath="sample.wav",
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+)
+
+print(result.generation.generationId)
+```
+
+## Restore audio in one call
+
+This helper runs the full flow and returns the downloaded bytes plus a metadata dict.
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+audio_bytes, info = client.restore_audio(
+    filePath="sample.wav",
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+    onProgress=lambda progress: print(progress.status),
+)
+
+if info["error"]:
+    print(info["error"])
+else:
+    with open("restored.mp3", "wb") as handle:
+        handle.write(audio_bytes)
+
+print(info["apiProjectId"], info["generationId"])
+```
+
+## Generation progress
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+progress = client.generations.get_progress(
+    generationId="gen_123",
+    apiProjectId="proj_123",
+)
+
+print(progress.status)
+```
+
+## Generation download
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+download = client.generations.download(
+    generationId="gen_123",
+    apiProjectId="proj_123",
+    downloadType="mp3",
+    downloadFilePath="restored.mp3",
+)
+
+print(download.downloadUrl)
+```
+
+If you only need the URL, use `client.generations.get_download`.
+
+## List projects
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+projects = client.projects.list()
+
+for project in projects.projects:
+    print(project.apiProjectId, project.status)
+```
+
+## List project generations
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+generations = client.projects.list_generations(apiProjectId="proj_123")
+
+for generation in generations.generations:
+    print(generation.generationId, generation.status)
+```
+
+## Webhooks portal access
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+portal = client.webhooks.get_portal_access(mode="test")
+print(portal.portalUrl)
+```
+
+## Send a test webhook event
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+event = client.webhooks.send_test_event(
+    eventType="generation.completed",
+    mode="test",
+    samplePayload={"apiProjectId": "proj_123"},
+)
+
+print(event.svixMessageId)
+```
+
+## Tutorials
+
+* Audio restoration CLI tutorial: `tutorials/audio-restoration-cli/README.md`
+
+## Runtime compatibility
+
+Use Python 3.8 or later.
+
+## Tests
+
+```bash
+cd diffio-python
+python -m pip install -r requirements-dev.txt
+python -m pytest
+```

diffio-0.1.0/README.md

@@ -0,0 +1,209 @@
+# Diffio Python SDK
+
+The Diffio Python SDK helps you call the Diffio API from Python. This version covers project creation, upload, generation, progress checks, and download URLs.
+Requires Python 3.8 or later.
+
+## Install
+
+```bash
+pip install diffio
+```
+
+For local development:
+
+```bash
+cd diffio-python
+pip install -e .
+```
+
+## Configuration
+
+Set the API key with `DIFFIO_API_KEY`. You can also override the base URL with `DIFFIO_API_BASE_URL`.
+
+```bash
+export DIFFIO_API_KEY="diffio_live_..."
+export DIFFIO_API_BASE_URL="https://us-central1-diffioai.cloudfunctions.net"
+```
+
+For emulators, set the base URL to the Functions emulator host.
+
+```bash
+export DIFFIO_API_BASE_URL="http://127.0.0.1:5001/diffioai/us-central1"
+```
+
+## Request options
+
+Use request options to override headers, timeouts, retries, or the API key per request.
+You can also pass `timeoutInSeconds` as an alias for `timeout`.
+
+```py
+from diffio import DiffioClient, RequestOptions
+
+client = DiffioClient(apiKey="diffio_live_...")
+projects = client.list_projects(
+    requestOptions=RequestOptions(
+        headers={"X-Debug": "1"},
+        timeout=30.0,
+        maxRetries=2,
+        retryBackoff=0.5,
+    )
+)
+```
+
+## Create a project and generation
+
+`create_project` uploads the file and returns the project metadata.
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+file_path = "sample.wav"
+project = client.create_project(
+    filePath=file_path,
+)
+
+generation = client.create_generation(
+    apiProjectId=project.apiProjectId,
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+)
+
+print(generation.generationId)
+```
+
+## Audio isolation helper
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+result = client.audio_isolation.isolate(
+    filePath="sample.wav",
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+)
+
+print(result.generation.generationId)
+```
+
+## Restore audio in one call
+
+This helper runs the full flow and returns the downloaded bytes plus a metadata dict.
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+audio_bytes, info = client.restore_audio(
+    filePath="sample.wav",
+    model="diffio-2",
+    sampling={"steps": 12, "guidance": 1.5},
+    onProgress=lambda progress: print(progress.status),
+)
+
+if info["error"]:
+    print(info["error"])
+else:
+    with open("restored.mp3", "wb") as handle:
+        handle.write(audio_bytes)
+
+print(info["apiProjectId"], info["generationId"])
+```
+
+## Generation progress
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+progress = client.generations.get_progress(
+    generationId="gen_123",
+    apiProjectId="proj_123",
+)
+
+print(progress.status)
+```
+
+## Generation download
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+download = client.generations.download(
+    generationId="gen_123",
+    apiProjectId="proj_123",
+    downloadType="mp3",
+    downloadFilePath="restored.mp3",
+)
+
+print(download.downloadUrl)
+```
+
+If you only need the URL, use `client.generations.get_download`.
+
+## List projects
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+projects = client.projects.list()
+
+for project in projects.projects:
+    print(project.apiProjectId, project.status)
+```
+
+## List project generations
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+generations = client.projects.list_generations(apiProjectId="proj_123")
+
+for generation in generations.generations:
+    print(generation.generationId, generation.status)
+```
+
+## Webhooks portal access
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+portal = client.webhooks.get_portal_access(mode="test")
+print(portal.portalUrl)
+```
+
+## Send a test webhook event
+
+```py
+from diffio import DiffioClient
+
+client = DiffioClient(apiKey="diffio_live_...")
+event = client.webhooks.send_test_event(
+    eventType="generation.completed",
+    mode="test",
+    samplePayload={"apiProjectId": "proj_123"},
+)
+
+print(event.svixMessageId)
+```
+
+## Tutorials
+
+* Audio restoration CLI tutorial: `tutorials/audio-restoration-cli/README.md`
+
+## Runtime compatibility
+
+Use Python 3.8 or later.
+
+## Tests
+
+```bash
+cd diffio-python
+python -m pip install -r requirements-dev.txt
+python -m pytest
+```

diffio-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "diffio"
+version = "0.1.0"
+description = "Python SDK for the Diffio API."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Diffio" }
+]
+dependencies = [
+    "httpx>=0.24.0"
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.0",
+    "pytest>=7.4",
+    "twine>=5.0",
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

diffio-0.1.0/setup.cfg

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

diffio-0.1.0/src/diffio/__init__.py

@@ -0,0 +1,59 @@
+from .client import (
+    AudioIsolationClient,
+    DiffioClient,
+    GenerationsClient,
+    ProjectsClient,
+    RequestOptions,
+    WebhooksClient,
+)
+from .errors import DiffioApiError
+from .types import (
+    AudioIsolationResult,
+    CreateGenerationResponse,
+    CreateProjectResponse,
+    DownloadType,
+    GenerationDownloadResponse,
+    GenerationProgressResponse,
+    GenerationProgressStage,
+    GenerationWebhookEvent,
+    GenerationWebhookStatus,
+    ListProjectGenerationsResponse,
+    ListProjectsResponse,
+    ModelKey,
+    ProjectGenerationSummary,
+    ProjectSummary,
+    WebhookEventType,
+    WebhookMode,
+    WebhookPortalResponse,
+    WebhookTestEventResponse,
+)
+
+__all__ = [
+    "AudioIsolationClient",
+    "AudioIsolationResult",
+    "CreateGenerationResponse",
+    "CreateProjectResponse",
+    "DownloadType",
+    "DiffioApiError",
+    "DiffioClient",
+    "GenerationDownloadResponse",
+    "GenerationProgressResponse",
+    "GenerationProgressStage",
+    "GenerationWebhookEvent",
+    "GenerationWebhookStatus",
+    "GenerationsClient",
+    "ListProjectGenerationsResponse",
+    "ListProjectsResponse",
+    "ModelKey",
+    "ProjectGenerationSummary",
+    "ProjectSummary",
+    "ProjectsClient",
+    "RequestOptions",
+    "WebhookEventType",
+    "WebhookMode",
+    "WebhookPortalResponse",
+    "WebhookTestEventResponse",
+    "WebhooksClient",
+]
+
+__version__ = "0.1.0"