suprsonic 0.1.0__tar.gz

suprsonic-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+node_modules/
+.streamlit/secrets.toml
+__pycache__/
+*.pyc
+
+logs/
+*.log
+test_results/
+
+.DS_Store
+.env
+.env.backup*
+data_exports/
+
+.turbo/
+.omega_dev_loop/
+meta_logs/
+
+backend/app/lib/oauth_automation/screenshots/
+backend/tmp/
+backend/tmp/**
+backend/tmp/omega/
+backend/tmp/omega/session_artifacts/
+backend/tmp/omega/session_artifacts/**
+tmp/
+tmp/browser_use_sessions/
+tmp/browser_use_sessions/**
+.specstory/
+
+# Prevent frontend symlink from being committed (causes Vercel build failures)
+# See commit db5d1d359 for context - symlink causes infinite path resolution on Vercel
+frontend

suprsonic-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: suprsonic
+Version: 0.1.0
+Summary: Suprsonic Python SDK. One API key, 17+ capabilities for your AI agent.
+Project-URL: Homepage, https://suprsonic.ai
+Project-URL: Documentation, https://suprsonic.ai/apis
+Project-URL: Repository, https://github.com/o-mega-ai/suprsonic-python
+License: MIT
+Keywords: ai-agent,mcp,suprsonic,unified-api
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# suprsonic
+
+Python SDK for [Suprsonic](https://suprsonic.ai). One API key, 17+ capabilities for your AI agent.
+
+## Install
+
+```bash
+pip install suprsonic
+```
+
+## Usage
+
+```python
+from suprsonic import Suprsonic
+
+client = Suprsonic("omk_your_key")
+
+# Search the web
+result = client.search("latest AI funding rounds")
+print(result.data)
+
+# Find a professional email
+result = client.emails.find(first_name="Yuma", last_name="Heymans", domain="o-mega.ai")
+print(result.data["email"])  # yuma@o-mega.ai
+
+# Scrape a webpage
+result = client.scrape("https://example.com")
+print(result.data["content"])
+
+# Any capability via .run()
+result = client.run("screenshot", url="https://example.com")
+```
+
+## All Capabilities
+
+search, scrape, profiles, emails, images, tts, stt, sms, documents, companies, email-verify, transcribe, invoice-parse, subtitle, file-convert, bg-remove, screenshot
+
+Get your API key at [suprsonic.ai](https://suprsonic.ai).

suprsonic-0.1.0/README.md

@@ -0,0 +1,38 @@
+# suprsonic
+
+Python SDK for [Suprsonic](https://suprsonic.ai). One API key, 17+ capabilities for your AI agent.
+
+## Install
+
+```bash
+pip install suprsonic
+```
+
+## Usage
+
+```python
+from suprsonic import Suprsonic
+
+client = Suprsonic("omk_your_key")
+
+# Search the web
+result = client.search("latest AI funding rounds")
+print(result.data)
+
+# Find a professional email
+result = client.emails.find(first_name="Yuma", last_name="Heymans", domain="o-mega.ai")
+print(result.data["email"])  # yuma@o-mega.ai
+
+# Scrape a webpage
+result = client.scrape("https://example.com")
+print(result.data["content"])
+
+# Any capability via .run()
+result = client.run("screenshot", url="https://example.com")
+```
+
+## All Capabilities
+
+search, scrape, profiles, emails, images, tts, stt, sms, documents, companies, email-verify, transcribe, invoice-parse, subtitle, file-convert, bg-remove, screenshot
+
+Get your API key at [suprsonic.ai](https://suprsonic.ai).

suprsonic-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "suprsonic"
+version = "0.1.0"
+description = "Suprsonic Python SDK. One API key, 17+ capabilities for your AI agent."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = ["httpx>=0.27"]
+keywords = ["suprsonic", "ai-agent", "unified-api", "mcp"]
+
+[project.urls]
+Homepage = "https://suprsonic.ai"
+Documentation = "https://suprsonic.ai/apis"
+Repository = "https://github.com/o-mega-ai/suprsonic-python"

suprsonic-0.1.0/suprsonic/__init__.py

@@ -0,0 +1,22 @@
+"""
+Suprsonic Python SDK.
+
+Usage:
+    from suprsonic import Suprsonic
+
+    client = Suprsonic("omk_your_key_here")
+
+    # Individual capabilities
+    result = client.search("latest AI funding rounds")
+    result = client.scrape("https://example.com")
+    result = client.emails.find(first_name="Yuma", last_name="Heymans", domain="o-mega.ai")
+    result = client.profiles.find(first_name="John", last_name="Doe", company="Stripe")
+
+    # Or use the meta API for any capability
+    result = client.run("search", query="latest AI news", mode="ai")
+"""
+
+from suprsonic.client import Suprsonic, SuprsonicResult
+
+__all__ = ["Suprsonic", "SuprsonicResult"]
+__version__ = "0.1.0"

suprsonic-0.1.0/suprsonic/client.py

@@ -0,0 +1,150 @@
+"""Suprsonic Python SDK client."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Optional
+
+import httpx
+
+
+@dataclass
+class SuprsonicResult:
+    """Result from a Suprsonic API call."""
+
+    success: bool
+    data: dict[str, Any] | None = None
+    error: dict[str, Any] | None = None
+    metadata: dict[str, Any] | None = None
+    credits_used: int = 0
+
+    @property
+    def provider(self) -> str | None:
+        return (self.metadata or {}).get("provider_used")
+
+    @property
+    def latency_ms(self) -> int:
+        return (self.metadata or {}).get("response_time_ms", 0)
+
+    @property
+    def request_id(self) -> str | None:
+        return (self.metadata or {}).get("request_id")
+
+
+class _CapabilityNamespace:
+    """Namespace for capability-specific methods (e.g. client.emails.find())."""
+
+    def __init__(self, client: Suprsonic, capability: str):
+        self._client = client
+        self._capability = capability
+
+    def find(self, **params: Any) -> SuprsonicResult:
+        return self._client.run(self._capability, **params)
+
+    def __call__(self, **params: Any) -> SuprsonicResult:
+        return self._client.run(self._capability, **params)
+
+
+class Suprsonic:
+    """
+    Suprsonic Python client.
+
+    Usage:
+        client = Suprsonic("omk_your_key_here")
+        result = client.search("latest AI news")
+        result = client.emails.find(first_name="Yuma", last_name="Heymans", domain="o-mega.ai")
+        result = client.run("scrape", url="https://example.com", mode="thorough")
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://o-mega.onrender.com",
+        timeout: float = 120.0,
+    ):
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        self._http = httpx.Client(
+            base_url=self._base_url,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "Content-Type": "application/json",
+            },
+            timeout=timeout,
+        )
+
+        # Capability namespaces
+        self.emails = _CapabilityNamespace(self, "emails")
+        self.profiles = _CapabilityNamespace(self, "profiles")
+        self.companies = _CapabilityNamespace(self, "companies")
+        self.documents = _CapabilityNamespace(self, "documents")
+
+    def run(self, capability: str, **params: Any) -> SuprsonicResult:
+        """
+        Call any Suprsonic capability via the Meta API.
+
+        Args:
+            capability: Capability name (search, scrape, emails, profiles, etc.)
+            **params: Parameters for the capability.
+
+        Returns:
+            SuprsonicResult with .success, .data, .error, .metadata, .credits_used
+        """
+        resp = self._http.post("/v1/agent", json={"capability": capability, "params": params})
+        body = resp.json()
+        return SuprsonicResult(
+            success=body.get("success", False),
+            data=body.get("data"),
+            error=body.get("error"),
+            metadata=body.get("metadata"),
+            credits_used=body.get("credits_used", 0),
+        )
+
+    # Convenience methods for common capabilities
+    def search(self, query: str, mode: str = "ai", **kwargs: Any) -> SuprsonicResult:
+        return self.run("search", query=query, mode=mode, **kwargs)
+
+    def scrape(self, url: str, mode: str = "standard", **kwargs: Any) -> SuprsonicResult:
+        return self.run("scrape", url=url, mode=mode, **kwargs)
+
+    def generate_image(self, prompt: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("images", prompt=prompt, **kwargs)
+
+    def tts(self, text: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("tts", text=text, **kwargs)
+
+    def stt(self, audio_url: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("stt", audio_url=audio_url, **kwargs)
+
+    def send_message(self, to: str, message: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("sms", to=to, message=message, **kwargs)
+
+    def verify_email(self, email: str) -> SuprsonicResult:
+        return self.run("email-verify", email=email)
+
+    def transcribe(self, audio_url: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("transcribe", audio_url=audio_url, **kwargs)
+
+    def parse_invoice(self, document_url: str) -> SuprsonicResult:
+        return self.run("invoice-parse", document_url=document_url)
+
+    def generate_subtitles(self, audio_url: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("subtitle", audio_url=audio_url, **kwargs)
+
+    def convert_file(self, file_url: str, source_format: str, target_format: str = "pdf") -> SuprsonicResult:
+        return self.run("file-convert", file_url=file_url, source_format=source_format, target_format=target_format)
+
+    def remove_background(self, image_url: str) -> SuprsonicResult:
+        return self.run("bg-remove", image_url=image_url)
+
+    def screenshot(self, url: str, **kwargs: Any) -> SuprsonicResult:
+        return self.run("screenshot", url=url, **kwargs)
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> Suprsonic:
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()