relancify-sdk 0.1.0__tar.gz

relancify_sdk-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+recursive-include relancify_sdk *.py

relancify_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: relancify-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Relancify API.
+Author: Relancify
+Project-URL: Homepage, https://www.relancify.com
+Project-URL: Repository, https://github.com/NKSTUD/relancify-sdk
+Project-URL: Documentation, https://www.relancify.com
+Keywords: relancify,sdk,voice,agent,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.25
+
+# Relancify SDK (Python)
+
+Official Python SDK for the Relancify API.
+
+## Installation
+
+```bash
+pip install relancify-sdk
+```
+
+## Quickstart
+
+```python
+from relancify_sdk import RelancifyClient
+
+client = RelancifyClient(
+    base_url="https://api.relancify.com/api/v1",
+    api_key="<your_api_key>",
+)
+
+agents = client.agents.list()
+print(len(agents))
+
+client.close()
+```
+
+## Available resources
+
+- `client.agents`
+- `client.runtime`
+- `client.users`
+- `client.voices`
+- `client.api_keys`
+
+## Notes
+
+- The SDK uses synchronous `httpx`.
+- HTTP errors are raised as `relancify_sdk.errors.ApiError`.
+
+## Security best practices
+
+- Never hardcode API keys or bearer tokens in source code.
+- Use environment variables or a secure secret manager.
+- Rotate credentials periodically.
+- Prefer short-lived access tokens when possible.

relancify_sdk-0.1.0/README.md

@@ -0,0 +1,45 @@
+# Relancify SDK (Python)
+
+Official Python SDK for the Relancify API.
+
+## Installation
+
+```bash
+pip install relancify-sdk
+```
+
+## Quickstart
+
+```python
+from relancify_sdk import RelancifyClient
+
+client = RelancifyClient(
+    base_url="https://api.relancify.com/api/v1",
+    api_key="<your_api_key>",
+)
+
+agents = client.agents.list()
+print(len(agents))
+
+client.close()
+```
+
+## Available resources
+
+- `client.agents`
+- `client.runtime`
+- `client.users`
+- `client.voices`
+- `client.api_keys`
+
+## Notes
+
+- The SDK uses synchronous `httpx`.
+- HTTP errors are raised as `relancify_sdk.errors.ApiError`.
+
+## Security best practices
+
+- Never hardcode API keys or bearer tokens in source code.
+- Use environment variables or a secure secret manager.
+- Rotate credentials periodically.
+- Prefer short-lived access tokens when possible.

relancify_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "relancify-sdk"
+version = "0.1.0"
+description = "Official Python SDK for the Relancify API."
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+  "httpx>=0.25,<1.0",
+]
+authors = [
+  { name = "Relancify" },
+]
+keywords = ["relancify", "sdk", "voice", "agent", "api"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://www.relancify.com"
+Repository = "https://github.com/NKSTUD/relancify-sdk"
+Documentation = "https://www.relancify.com"
+
+[tool.setuptools.packages.find]
+include = ["relancify_sdk*"]

relancify_sdk-0.1.0/relancify_sdk/__init__.py

@@ -0,0 +1,6 @@
+from relancify_sdk.client import RelancifyClient
+from relancify_sdk.errors import ApiError, RelancifyError
+
+__version__ = "0.1.0"
+
+__all__ = ["RelancifyClient", "RelancifyError", "ApiError", "__version__"]

relancify_sdk-0.1.0/relancify_sdk/auth.py

@@ -0,0 +1,16 @@
+from dataclasses import dataclass
+from typing import Dict, Optional
+
+
+@dataclass(frozen=True)
+class AuthConfig:
+    api_key: Optional[str] = None
+    bearer: Optional[str] = None
+
+    def apply(self, headers: Dict[str, str]) -> Dict[str, str]:
+        resolved = dict(headers)
+        if self.api_key:
+            resolved["X-API-Key"] = self.api_key
+        if self.bearer:
+            resolved["Authorization"] = f"Bearer {self.bearer}"
+        return resolved

relancify_sdk-0.1.0/relancify_sdk/client.py

@@ -0,0 +1,29 @@
+from typing import Optional
+
+from relancify_sdk.auth import AuthConfig
+from relancify_sdk.http import HttpClient
+from relancify_sdk.resources.agents import AgentsResource
+from relancify_sdk.resources.api_keys import ApiKeysResource
+from relancify_sdk.resources.runtime import RuntimeResource
+from relancify_sdk.resources.users import UsersResource
+from relancify_sdk.resources.voices import VoicesResource
+
+
+class RelancifyClient:
+    def __init__(
+        self,
+        base_url: str = "http://localhost:8000/api/v1",
+        api_key: Optional[str] = None,
+        bearer: Optional[str] = None,
+        timeout: float = 30.0,
+    ) -> None:
+        auth = AuthConfig(api_key=api_key, bearer=bearer)
+        self._http = HttpClient(base_url=base_url, auth=auth, timeout=timeout)
+        self.agents = AgentsResource(self._http)
+        self.api_keys = ApiKeysResource(self._http)
+        self.runtime = RuntimeResource(self._http)
+        self.users = UsersResource(self._http)
+        self.voices = VoicesResource(self._http)
+
+    def close(self) -> None:
+        self._http.close()

relancify_sdk-0.1.0/relancify_sdk/errors.py

@@ -0,0 +1,12 @@
+from typing import Any, Optional
+
+
+class RelancifyError(Exception):
+    pass
+
+
+class ApiError(RelancifyError):
+    def __init__(self, message: str, status_code: Optional[int] = None, detail: Any = None) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+        self.detail = detail

relancify_sdk-0.1.0/relancify_sdk/http.py

@@ -0,0 +1,53 @@
+from typing import Any, Dict, Optional
+
+import httpx
+
+from relancify_sdk.auth import AuthConfig
+from relancify_sdk.errors import ApiError
+
+
+class HttpClient:
+    def __init__(
+        self,
+        base_url: str,
+        auth: AuthConfig,
+        timeout: float = 30.0,
+    ) -> None:
+        self._base_url = base_url.rstrip("/")
+        self._client = httpx.Client(base_url=self._base_url, timeout=timeout)
+        self._auth = auth
+
+    @property
+    def base_url(self) -> str:
+        return self._base_url
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        json: Optional[Dict[str, Any]] = None,
+        headers: Optional[Dict[str, str]] = None,
+    ) -> Any:
+        payload_headers = headers or {}
+        merged_headers = self._auth.apply(payload_headers)
+        response = self._client.request(method, path, json=json, headers=merged_headers)
+        if response.status_code >= 400:
+            detail = None
+            try:
+                detail = response.json()
+            except ValueError:
+                detail = response.text
+            raise ApiError(
+                message=detail.get("detail") if isinstance(detail, dict) else str(detail),
+                status_code=response.status_code,
+                detail=detail,
+            )
+        if response.status_code == 204:
+            return None
+        content_type = response.headers.get("content-type", "")
+        if "application/json" in content_type:
+            return response.json()
+        return response.text
+
+    def close(self) -> None:
+        self._client.close()

relancify_sdk-0.1.0/relancify_sdk/resources/__init__.py

@@ -0,0 +1 @@
+__all__ = ["agents", "api_keys", "runtime", "users", "voices"]

relancify_sdk-0.1.0/relancify_sdk/resources/agents.py

@@ -0,0 +1,63 @@
+from typing import Any, Dict, List, Optional
+
+from relancify_sdk.http import HttpClient
+
+
+class AgentsResource:
+    def __init__(self, client: HttpClient) -> None:
+        self._client = client
+
+    def list(self) -> List[Dict[str, Any]]:
+        return self._client.request("GET", "/agents")
+
+    def get(self, agent_id: str) -> Dict[str, Any]:
+        return self._client.request("GET", f"/agents/{agent_id}")
+
+    def create(self, payload: Dict[str, Any], sync: bool = True) -> Dict[str, Any]:
+        path = "/agents/sync" if sync else "/agents"
+        return self._client.request("POST", path, json=payload)
+
+    def update(self, agent_id: str, payload: Dict[str, Any], sync: bool = True) -> Dict[str, Any]:
+        path = f"/agents/{agent_id}/sync" if sync else f"/agents/{agent_id}"
+        return self._client.request("PUT", path, json=payload)
+
+    def delete(self, agent_id: str) -> None:
+        self._client.request("DELETE", f"/agents/{agent_id}")
+
+    def get_provider_config(self, agent_id: str) -> Dict[str, Any]:
+        return self._client.request("GET", f"/agents/{agent_id}/provider")
+
+    def create_runtime_session(self, agent_id: str) -> Dict[str, Any]:
+        return self._client.request("POST", f"/agents/{agent_id}/runtime/session")
+
+    def normalize_runtime_event(self, agent_id: str, event: Dict[str, Any]) -> Dict[str, Any]:
+        return self._client.request(
+            "POST",
+            f"/agents/{agent_id}/runtime/events/normalize",
+            json={"event": event},
+        )
+
+    def compile_runtime_event(
+        self,
+        agent_id: str,
+        *,
+        event_type: str,
+        event_id: Optional[str] = None,
+        text: Optional[str] = None,
+        audio_base64: Optional[str] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        raw_payload: Optional[Dict[str, Any]] = None,
+    ) -> Dict[str, Any]:
+        payload: Dict[str, Any] = {
+            "type": event_type,
+            "event_id": event_id,
+            "text": text,
+            "audio_base64": audio_base64,
+            "metadata": metadata or {},
+            "raw_payload": raw_payload or {},
+        }
+        return self._client.request(
+            "POST",
+            f"/agents/{agent_id}/runtime/events/compile",
+            json=payload,
+        )

relancify_sdk-0.1.0/relancify_sdk/resources/api_keys.py

@@ -0,0 +1,17 @@
+from typing import Any, Dict, List
+
+from relancify_sdk.http import HttpClient
+
+
+class ApiKeysResource:
+    def __init__(self, client: HttpClient) -> None:
+        self._client = client
+
+    def list(self) -> List[Dict[str, Any]]:
+        return self._client.request("GET", "/api-keys")
+
+    def create(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        return self._client.request("POST", "/api-keys", json=payload)
+
+    def revoke(self, api_key_id: str) -> None:
+        self._client.request("DELETE", f"/api-keys/{api_key_id}")

relancify_sdk-0.1.0/relancify_sdk/resources/runtime.py

@@ -0,0 +1,29 @@
+from typing import Any, Dict, Optional
+from urllib.parse import quote
+
+from relancify_sdk.http import HttpClient
+
+
+class RuntimeResource:
+    def __init__(self, client: HttpClient) -> None:
+        self._client = client
+
+    def get_session(self, session_id: str) -> Dict[str, Any]:
+        return self._client.request("GET", f"/runtime/sessions/{session_id}")
+
+    def close_session(self, session_id: str) -> Dict[str, Any]:
+        return self._client.request("DELETE", f"/runtime/sessions/{session_id}")
+
+    def build_websocket_url(
+        self, session_id: str, access_token: Optional[str] = None
+    ) -> str:
+        ws_base = self._client.base_url
+        if ws_base.startswith("https://"):
+            ws_base = "wss://" + ws_base[len("https://") :]
+        elif ws_base.startswith("http://"):
+            ws_base = "ws://" + ws_base[len("http://") :]
+
+        if access_token:
+            token = quote(access_token, safe="")
+            return f"{ws_base}/runtime/sessions/{session_id}?access_token={token}"
+        return f"{ws_base}/runtime/sessions/{session_id}"

relancify_sdk-0.1.0/relancify_sdk/resources/users.py

@@ -0,0 +1,11 @@
+from typing import Any, Dict
+
+from relancify_sdk.http import HttpClient
+
+
+class UsersResource:
+    def __init__(self, client: HttpClient) -> None:
+        self._client = client
+
+    def me(self) -> Dict[str, Any]:
+        return self._client.request("GET", "/users/me")

relancify_sdk-0.1.0/relancify_sdk/resources/voices.py

@@ -0,0 +1,11 @@
+from typing import Any, Dict, List
+
+from relancify_sdk.http import HttpClient
+
+
+class VoicesResource:
+    def __init__(self, client: HttpClient) -> None:
+        self._client = client
+
+    def list(self) -> List[Dict[str, Any]]:
+        return self._client.request("GET", "/voices")

relancify_sdk-0.1.0/relancify_sdk/types/__init__.py

@@ -0,0 +1 @@
+__all__ = []

relancify_sdk-0.1.0/relancify_sdk.egg-info/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: relancify-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Relancify API.
+Author: Relancify
+Project-URL: Homepage, https://www.relancify.com
+Project-URL: Repository, https://github.com/NKSTUD/relancify-sdk
+Project-URL: Documentation, https://www.relancify.com
+Keywords: relancify,sdk,voice,agent,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.25
+
+# Relancify SDK (Python)
+
+Official Python SDK for the Relancify API.
+
+## Installation
+
+```bash
+pip install relancify-sdk
+```
+
+## Quickstart
+
+```python
+from relancify_sdk import RelancifyClient
+
+client = RelancifyClient(
+    base_url="https://api.relancify.com/api/v1",
+    api_key="<your_api_key>",
+)
+
+agents = client.agents.list()
+print(len(agents))
+
+client.close()
+```
+
+## Available resources
+
+- `client.agents`
+- `client.runtime`
+- `client.users`
+- `client.voices`
+- `client.api_keys`
+
+## Notes
+
+- The SDK uses synchronous `httpx`.
+- HTTP errors are raised as `relancify_sdk.errors.ApiError`.
+
+## Security best practices
+
+- Never hardcode API keys or bearer tokens in source code.
+- Use environment variables or a secure secret manager.
+- Rotate credentials periodically.
+- Prefer short-lived access tokens when possible.

relancify_sdk-0.1.0/relancify_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+MANIFEST.in
+README.md
+pyproject.toml
+relancify_sdk/__init__.py
+relancify_sdk/auth.py
+relancify_sdk/client.py
+relancify_sdk/errors.py
+relancify_sdk/http.py
+relancify_sdk.egg-info/PKG-INFO
+relancify_sdk.egg-info/SOURCES.txt
+relancify_sdk.egg-info/dependency_links.txt
+relancify_sdk.egg-info/requires.txt
+relancify_sdk.egg-info/top_level.txt
+relancify_sdk/resources/__init__.py
+relancify_sdk/resources/agents.py
+relancify_sdk/resources/api_keys.py
+relancify_sdk/resources/runtime.py
+relancify_sdk/resources/users.py
+relancify_sdk/resources/voices.py
+relancify_sdk/types/__init__.py

relancify_sdk-0.1.0/relancify_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

relancify_sdk-0.1.0/relancify_sdk.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx<1.0,>=0.25

relancify_sdk-0.1.0/relancify_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+relancify_sdk

relancify_sdk-0.1.0/setup.cfg

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