oruk 0.1.0__tar.gz

oruk-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# v0 sandbox internal files
+__v0_runtime_loader.js
+__v0_devtools.tsx
+__v0_jsx-dev-runtime.ts
+.snowflake/
+.v0-trash/
+.lazyweb/
+
+# Environment variables
+.env*.local
+.dev.vars
+
+# Social media exports (large, not part of the app)
+twitter-gifs/
+
+# Local browser-test scratch (screenshots, Playwright venv)
+.demo-work/
+
+# Common ignores
+__pycache__/
+node_modules
+.next/
+out/
+.wrangler/
+.open-next/
+gha-creds-*.json
+cloudflare-env.d.ts
+tsconfig.tsbuildinfo
+.DS_Store
+hr/
+legal/
+
+# Confidential legal materials (separate private repo: Oruk-AI/oruk-legal)
+legal/

oruk-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: oruk
+Version: 0.1.0
+Summary: Official Python client for the oruk Speech API: English transcription, calibrated multilabel emotion and speaking-style labels, and unified audio analysis.
+Project-URL: Homepage, https://oruk.ai
+Project-URL: Documentation, https://oruk.ai/docs
+Project-URL: Changelog, https://oruk.ai/changelog
+Project-URL: Source, https://github.com/Oruk-AI/oruk-speech-lab
+Project-URL: Pricing, https://oruk.ai/pricing
+Author-email: oruk labs <access@oruk.ai>
+License: MIT
+Keywords: audio analysis,emotion detection,oruk,paralinguistics,speech,speech emotion recognition,speech understanding,speech-to-text,transcription
+Classifier: Development Status :: 4 - Beta
+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
+Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Description-Content-Type: text/markdown
+
+# oruk — Python client for the oruk Speech API
+
+Official Python SDK for [oruk](https://oruk.ai), the speech lab building audio
+models for English transcription, calibrated multilabel emotion detection,
+speaking-style classification, and unified audio analysis.
+
+The API is file-based: send a prerecorded English audio file (WAV, FLAC, MP3,
+M4A, OGG, or WebM; up to 30 MB / 60 minutes), get structured results back.
+Usage is metered per second of audio.
+
+## Install
+
+```bash
+pip install oruk
+```
+
+## Quickstart
+
+Create an account at [oruk.ai](https://oruk.ai/auth/signup) ($5 trial credit,
+no card required) and create an API key in the developer portal.
+
+```python
+import os
+from oruk import Oruk
+
+with Oruk(api_key=os.environ["ORUK_API_KEY"]) as client:
+    result = client.analyze("sample.wav", model="oruk-resonance")
+
+print(result["text"])       # English transcript
+print(result["emotions"])   # calibrated multilabel emotion scores
+print(result["styles"])     # calibrated multilabel speaking-style scores
+```
+
+## Endpoints
+
+| Method | API endpoint | Returns |
+|---|---|---|
+| `client.transcribe(file)` | `POST /v1/audio/transcriptions` | English transcript |
+| `client.emotions(file)` | `POST /v1/audio/emotions` | 15 calibrated emotion labels |
+| `client.styles(file)` | `POST /v1/audio/styles` | 16 calibrated speaking-style labels |
+| `client.affect(file)` | `POST /v1/audio/affect` | emotion + style, no transcript |
+| `client.analyze(file)` | `POST /v1/audio/analysis` | transcript, labels, segments, tagged text |
+
+Every method accepts a path, `Path`, or binary file object, plus optional
+`model=` (`oruk-resonance`, `oruk-spectra-1`) and `request_id=` arguments.
+
+The client sends a unique request ID per call and retries only 429 and
+transient 5xx responses with jittered backoff. Errors raise `OrukAPIError`
+with `status`, `code`, and `request_id` attributes.
+
+## Links
+
+- Documentation and API reference: <https://oruk.ai/docs>
+- Capabilities and scope: <https://oruk.ai/capabilities>
+- Pricing: <https://oruk.ai/pricing>
+- Benchmarks: <https://oruk.ai/benchmarks/methodology>
+- Service status: <https://oruk.ai/status>
+
+## License
+
+MIT

oruk-0.1.0/README.md

@@ -0,0 +1,61 @@
+# oruk — Python client for the oruk Speech API
+
+Official Python SDK for [oruk](https://oruk.ai), the speech lab building audio
+models for English transcription, calibrated multilabel emotion detection,
+speaking-style classification, and unified audio analysis.
+
+The API is file-based: send a prerecorded English audio file (WAV, FLAC, MP3,
+M4A, OGG, or WebM; up to 30 MB / 60 minutes), get structured results back.
+Usage is metered per second of audio.
+
+## Install
+
+```bash
+pip install oruk
+```
+
+## Quickstart
+
+Create an account at [oruk.ai](https://oruk.ai/auth/signup) ($5 trial credit,
+no card required) and create an API key in the developer portal.
+
+```python
+import os
+from oruk import Oruk
+
+with Oruk(api_key=os.environ["ORUK_API_KEY"]) as client:
+    result = client.analyze("sample.wav", model="oruk-resonance")
+
+print(result["text"])       # English transcript
+print(result["emotions"])   # calibrated multilabel emotion scores
+print(result["styles"])     # calibrated multilabel speaking-style scores
+```
+
+## Endpoints
+
+| Method | API endpoint | Returns |
+|---|---|---|
+| `client.transcribe(file)` | `POST /v1/audio/transcriptions` | English transcript |
+| `client.emotions(file)` | `POST /v1/audio/emotions` | 15 calibrated emotion labels |
+| `client.styles(file)` | `POST /v1/audio/styles` | 16 calibrated speaking-style labels |
+| `client.affect(file)` | `POST /v1/audio/affect` | emotion + style, no transcript |
+| `client.analyze(file)` | `POST /v1/audio/analysis` | transcript, labels, segments, tagged text |
+
+Every method accepts a path, `Path`, or binary file object, plus optional
+`model=` (`oruk-resonance`, `oruk-spectra-1`) and `request_id=` arguments.
+
+The client sends a unique request ID per call and retries only 429 and
+transient 5xx responses with jittered backoff. Errors raise `OrukAPIError`
+with `status`, `code`, and `request_id` attributes.
+
+## Links
+
+- Documentation and API reference: <https://oruk.ai/docs>
+- Capabilities and scope: <https://oruk.ai/capabilities>
+- Pricing: <https://oruk.ai/pricing>
+- Benchmarks: <https://oruk.ai/benchmarks/methodology>
+- Service status: <https://oruk.ai/status>
+
+## License
+
+MIT

oruk-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "oruk"
+version = "0.1.0"
+description = "Official Python client for the oruk Speech API: English transcription, calibrated multilabel emotion and speaking-style labels, and unified audio analysis."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "oruk labs", email = "access@oruk.ai" }]
+keywords = [
+  "speech",
+  "speech-to-text",
+  "transcription",
+  "speech emotion recognition",
+  "emotion detection",
+  "paralinguistics",
+  "speech understanding",
+  "audio analysis",
+  "oruk",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "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",
+  "Topic :: Multimedia :: Sound/Audio :: Analysis",
+  "Topic :: Multimedia :: Sound/Audio :: Speech",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["httpx>=0.27,<1"]
+
+[project.urls]
+Homepage = "https://oruk.ai"
+Documentation = "https://oruk.ai/docs"
+Changelog = "https://oruk.ai/changelog"
+Source = "https://github.com/Oruk-AI/oruk-speech-lab"
+Pricing = "https://oruk.ai/pricing"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/oruk"]

oruk-0.1.0/src/oruk/__init__.py

@@ -0,0 +1,3 @@
+from .client import Oruk, OrukAPIError
+
+__all__ = ["Oruk", "OrukAPIError"]

oruk-0.1.0/src/oruk/client.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+import mimetypes
+import random
+import time
+import uuid
+from pathlib import Path
+from typing import Any, BinaryIO
+
+import httpx
+
+
+class OrukAPIError(RuntimeError):
+    def __init__(self, message: str, status: int, code: str | None = None, request_id: str | None = None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+        self.request_id = request_id
+
+
+class Oruk:
+    _RETRYABLE = {429, 500, 502, 503, 504}
+
+    def __init__(
+        self,
+        api_key: str,
+        *,
+        base_url: str = "https://speech-api.oruk.ai",
+        timeout: float = 120.0,
+        max_retries: int = 2,
+    ) -> None:
+        if not api_key:
+            raise ValueError("api_key is required")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.max_retries = max_retries
+        self._client = httpx.Client(timeout=timeout)
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "Oruk":
+        return self
+
+    def __exit__(self, *_: object) -> None:
+        self.close()
+
+    def transcribe(self, file: str | Path | BinaryIO, **kwargs: Any) -> dict[str, Any]:
+        return self.request("transcriptions", file, **kwargs)
+
+    def emotions(self, file: str | Path | BinaryIO, **kwargs: Any) -> dict[str, Any]:
+        return self.request("emotions", file, **kwargs)
+
+    def styles(self, file: str | Path | BinaryIO, **kwargs: Any) -> dict[str, Any]:
+        return self.request("styles", file, **kwargs)
+
+    def affect(self, file: str | Path | BinaryIO, **kwargs: Any) -> dict[str, Any]:
+        return self.request("affect", file, **kwargs)
+
+    def analyze(self, file: str | Path | BinaryIO, **kwargs: Any) -> dict[str, Any]:
+        return self.request("analysis", file, **kwargs)
+
+    def request(
+        self,
+        task: str,
+        file: str | Path | BinaryIO,
+        *,
+        model: str | None = None,
+        request_id: str | None = None,
+    ) -> dict[str, Any]:
+        request_id = request_id or str(uuid.uuid4())
+        owned_file: BinaryIO | None = None
+        if isinstance(file, (str, Path)):
+            path = Path(file)
+            owned_file = path.open("rb")
+            stream = owned_file
+            filename = path.name
+        else:
+            stream = file
+            filename = Path(getattr(file, "name", "audio.wav")).name
+        content_type = mimetypes.guess_type(filename)[0] or "application/octet-stream"
+        try:
+            for attempt in range(self.max_retries + 1):
+                if hasattr(stream, "seek"):
+                    stream.seek(0)
+                response = self._client.post(
+                    f"{self.base_url}/v1/audio/{task}",
+                    headers={
+                        "Authorization": f"Bearer {self.api_key}",
+                        "X-Request-ID": request_id,
+                    },
+                    files={"file": (filename, stream, content_type)},
+                    data={"model": model} if model else None,
+                )
+                if response.is_success:
+                    return response.json()
+                try:
+                    error = response.json().get("error", {})
+                except ValueError:
+                    error = {}
+                failure = OrukAPIError(
+                    error.get("message") or f"Oruk API returned HTTP {response.status_code}",
+                    response.status_code,
+                    error.get("code"),
+                    error.get("request_id") or response.headers.get("x-request-id"),
+                )
+                if response.status_code not in self._RETRYABLE or attempt == self.max_retries:
+                    raise failure
+                time.sleep(0.25 * (2**attempt) + random.random() * 0.1)
+        finally:
+            if owned_file:
+                owned_file.close()
+        raise RuntimeError("Oruk request failed")