hypercli-sdk 0.4.2__py3-none-any.whl

c3/renders.py

@@ -0,0 +1,339 @@
+"""Renders API"""
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, List, Optional
+
+if TYPE_CHECKING:
+    from .http import HTTPClient
+
+
+@dataclass
+class Render:
+    render_id: str
+    state: str
+    template: str | None = None
+    render_type: str | None = None
+    result_url: str | None = None
+    error: str | None = None
+    created_at: float | None = None
+    started_at: float | None = None
+    completed_at: float | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Render":
+        return cls(
+            render_id=data.get("id") or data.get("render_id", ""),
+            state=data.get("state", ""),
+            template=data.get("template") or data.get("meta", {}).get("template"),
+            render_type=data.get("type") or data.get("render_type"),
+            result_url=data.get("result_url"),
+            error=data.get("error"),
+            created_at=data.get("created_at"),
+            started_at=data.get("started_at"),
+            completed_at=data.get("completed_at"),
+        )
+
+
+@dataclass
+class RenderStatus:
+    render_id: str
+    state: str
+    progress: float | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "RenderStatus":
+        return cls(
+            render_id=data.get("id") or data.get("render_id", ""),
+            state=data.get("state", ""),
+            progress=data.get("progress"),
+        )
+
+
+class Renders:
+    """Renders API wrapper"""
+
+    def __init__(self, http: "HTTPClient"):
+        self._http = http
+
+    def list(
+        self,
+        state: str = None,
+        template: str = None,
+        type: str = None,
+    ) -> list[Render]:
+        """List all renders.
+
+        Args:
+            state: Filter by state (e.g., "pending", "running", "completed")
+            template: Filter by template name
+            type: Filter by render type (e.g., "comfyui")
+        """
+        params = {}
+        if state:
+            params["state"] = state
+        if template:
+            params["template"] = template
+        if type:
+            params["type"] = type
+
+        data = self._http.get("/api/renders", params=params or None)
+        # Handle paginated response
+        items = data.get("items", data) if isinstance(data, dict) else data
+        return [Render.from_dict(r) for r in items]
+
+    def get(self, render_id: str) -> Render:
+        """Get render details"""
+        data = self._http.get(f"/api/renders/{render_id}")
+        return Render.from_dict(data)
+
+    def create(
+        self,
+        params: dict,
+        render_type: str = "comfyui",
+        notify_url: str = None,
+    ) -> Render:
+        """Create a new render.
+
+        Args:
+            params: Render parameters (workflow-specific)
+            render_type: Type of render (default: "comfyui")
+            notify_url: Optional webhook URL for completion notification
+        """
+        payload = {
+            "type": render_type,
+            "params": params,
+        }
+        if notify_url:
+            payload["notify_url"] = notify_url
+
+        data = self._http.post("/api/renders", json=payload)
+        return Render.from_dict(data)
+
+    def cancel(self, render_id: str) -> dict:
+        """Cancel a render"""
+        return self._http.delete(f"/api/renders/{render_id}")
+
+    def status(self, render_id: str) -> RenderStatus:
+        """Get render status (lightweight polling endpoint)"""
+        data = self._http.get(f"/api/renders/{render_id}/status")
+        return RenderStatus.from_dict(data)
+
+    # =========================================================================
+    # Flow endpoints - simplified interfaces
+    # =========================================================================
+
+    def _flow(self, endpoint: str, **kwargs) -> Render:
+        """Helper for flow endpoints. Filters None values from payload."""
+        payload = {k: v for k, v in kwargs.items() if v is not None}
+        data = self._http.post(endpoint, json=payload)
+        return Render.from_dict(data)
+
+    def text_to_image(
+        self,
+        prompt: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate an image using Qwen-Image (great for text in images).
+
+        Args:
+            prompt: Text description of the image
+            negative: Optional negative prompt (things to avoid)
+            width: Optional output width
+            height: Optional output height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.text_to_image("a cat wearing sunglasses")
+        """
+        return self._flow("/api/flow/text-to-image", prompt=prompt, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def text_to_image_hidream(
+        self,
+        prompt: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate an image using HiDream I1 Full (highest quality).
+
+        Args:
+            prompt: Text description of the image
+            negative: Optional negative prompt (things to avoid)
+            width: Optional output width
+            height: Optional output height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.text_to_image_hidream("a mystical forest")
+        """
+        return self._flow("/api/flow/text-to-image-hidream", prompt=prompt, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def text_to_video(
+        self,
+        prompt: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate a video using Wan 2.2 14B.
+
+        Args:
+            prompt: Text description of the video
+            negative: Optional negative prompt (things to avoid)
+            width: Optional video width
+            height: Optional video height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.text_to_video("a cat walking through a garden")
+        """
+        return self._flow("/api/flow/text-to-video", prompt=prompt, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def image_to_video(
+        self,
+        prompt: str,
+        image_url: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Animate an image using Wan 2.2 Animate.
+
+        Args:
+            prompt: Description of the motion/animation
+            image_url: URL of the image to animate
+            negative: Optional negative prompt (things to avoid)
+            width: Optional video width
+            height: Optional video height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.image_to_video("dancing", "https://example.com/img.png", width=832, height=480)
+        """
+        return self._flow("/api/flow/image-to-video", prompt=prompt, image_url=image_url, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def speaking_video(
+        self,
+        prompt: str,
+        image_url: str,
+        audio_url: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate a lip-sync video using HuMo.
+
+        Args:
+            prompt: Description of the scene/character
+            image_url: URL of the face/character image
+            audio_url: URL of the audio/speech file
+            negative: Optional negative prompt (things to avoid)
+            width: Optional video width
+            height: Optional video height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.speaking_video(
+                "A person talking to camera",
+                "https://example.com/face.png",
+                "https://example.com/speech.mp3"
+            )
+        """
+        return self._flow("/api/flow/speaking-video", prompt=prompt, image_url=image_url, audio_url=audio_url, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def speaking_video_wan(
+        self,
+        prompt: str,
+        image_url: str,
+        audio_url: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate an audio-driven video using Wan 2.2 S2V.
+
+        Args:
+            prompt: Description of the scene/action
+            image_url: URL of the image
+            audio_url: URL of the audio file
+            negative: Optional negative prompt (things to avoid)
+            width: Optional video width
+            height: Optional video height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.speaking_video_wan(
+                "The person is singing",
+                "https://example.com/face.png",
+                "https://example.com/song.mp3"
+            )
+        """
+        return self._flow("/api/flow/speaking-video-wan", prompt=prompt, image_url=image_url, audio_url=audio_url, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def image_to_image(
+        self,
+        prompt: str,
+        image_urls: List[str],
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Transform images using Qwen Image Edit with 1-3 input images.
+
+        Args:
+            prompt: Description of the transformation
+            image_urls: List of 1-3 image URLs (first is main, others are references)
+            negative: Optional negative prompt (things to avoid)
+            width: Optional output width
+            height: Optional output height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.image_to_image(
+                "Apply the artistic style from the references",
+                [
+                    "https://example.com/subject.jpg",
+                    "https://example.com/style1.jpg",
+                    "https://example.com/style2.jpg",
+                ]
+            )
+        """
+        return self._flow("/api/flow/image-to-image", prompt=prompt, image_urls=image_urls, negative=negative, width=width, height=height, notify_url=notify_url)
+
+    def first_last_frame_video(
+        self,
+        prompt: str,
+        start_image_url: str,
+        end_image_url: str,
+        negative: str = None,
+        width: int = None,
+        height: int = None,
+        notify_url: str = None,
+    ) -> Render:
+        """Generate video morphing between two images using Wan 2.2.
+
+        Args:
+            prompt: Description of the transition/motion
+            start_image_url: URL of the starting frame
+            end_image_url: URL of the ending frame
+            negative: Optional negative prompt (things to avoid)
+            width: Optional video width
+            height: Optional video height
+            notify_url: Optional webhook URL for completion notification
+
+        Example:
+            render = c3.renders.first_last_frame_video(
+                "smooth transition from day to night",
+                "https://example.com/day.png",
+                "https://example.com/night.png"
+            )
+        """
+        return self._flow("/api/flow/first-last-frame-video", prompt=prompt, start_image_url=start_image_url, end_image_url=end_image_url, negative=negative, width=width, height=height, notify_url=notify_url)

c3/user.py

@@ -0,0 +1,37 @@
+"""User API"""
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .http import HTTPClient
+
+
+@dataclass
+class User:
+    user_id: str
+    email: str | None
+    name: str | None
+    is_active: bool
+    created_at: str
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "User":
+        return cls(
+            user_id=data.get("user_id", ""),
+            email=data.get("email"),
+            name=data.get("name"),
+            is_active=data.get("is_active", True),
+            created_at=data.get("created_at", ""),
+        )
+
+
+class UserAPI:
+    """User API wrapper"""
+
+    def __init__(self, http: "HTTPClient"):
+        self._http = http
+
+    def get(self) -> User:
+        """Get current user info"""
+        data = self._http.get("/api/user")
+        return User.from_dict(data)

hypercli_sdk-0.4.2.dist-info/METADATA

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: hypercli-sdk
+Version: 0.4.2
+Summary: Python SDK for HyperCLI - GPU orchestration and LLM API
+Project-URL: Homepage, https://hypercli.com
+Project-URL: Documentation, https://docs.hypercli.com
+Project-URL: Repository, https://github.com/hypercli/sdk-python
+Author-email: HyperCLI <support@hypercli.com>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: websockets>=15.0.1
+Provides-Extra: comfyui
+Requires-Dist: comfyui-workflow-templates-media-image>=0.3.0; extra == 'comfyui'
+Requires-Dist: comfyui-workflow-templates>=0.7.0; extra == 'comfyui'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# C3 SDK
+
+Python SDK for [HyperCLI](https://hypercli.com) - GPU orchestration API.
+
+## Installation
+
+```bash
+pip install c3-sdk
+```
+
+## Setup
+
+Set your API key:
+
+```bash
+export C3_API_KEY=your_api_key
+```
+
+Or create `~/.c3/config`:
+```
+C3_API_KEY=your_api_key
+```
+
+Or pass directly:
+```python
+c3 = C3(api_key="your_api_key")
+```
+
+## Usage
+
+```python
+from c3 import C3
+
+c3 = C3()
+
+# Check balance
+balance = c3.billing.balance()
+print(f"Balance: ${balance.total:.2f}")
+print(f"Rewards: ${balance.rewards:.2f}")
+
+# List transactions
+for tx in c3.billing.transactions(limit=10):
+    print(f"{tx.transaction_type}: ${tx.amount_usd:.4f}")
+
+# Create a job
+job = c3.jobs.create(
+    image="nvidia/cuda:12.0",
+    command="python train.py",
+    gpu_type="l40s",
+    gpu_count=1,
+)
+print(f"Job ID: {job.job_id}")
+print(f"State: {job.state}")
+
+# List jobs
+for job in c3.jobs.list():
+    print(f"{job.job_id}: {job.state}")
+
+# Get job details
+job = c3.jobs.get("job_id")
+
+# Get job logs
+logs = c3.jobs.logs("job_id")
+
+# Get GPU metrics
+metrics = c3.jobs.metrics("job_id")
+for gpu in metrics.gpus:
+    print(f"GPU {gpu.index}: {gpu.utilization}% util, {gpu.temperature}°C")
+
+# Cancel a job
+c3.jobs.cancel("job_id")
+
+# Extend runtime
+c3.jobs.extend("job_id", runtime=7200)
+
+# Get user info
+user = c3.user.get()
+print(f"User: {user.email}")
+```
+
+## LLM API
+
+For LLM access, use the OpenAI SDK with C3's base URL:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    api_key="your_c3_api_key",
+    base_url="https://api.hypercli.com/v1"
+)
+
+response = client.chat.completions.create(
+    model="deepseek-v3.1",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Error Handling
+
+```python
+from c3 import C3, APIError
+
+c3 = C3()
+
+try:
+    job = c3.jobs.get("invalid_id")
+except APIError as e:
+    print(f"Error {e.status_code}: {e.detail}")
+```
+
+## License
+
+MIT

hypercli_sdk-0.4.2.dist-info/RECORD

@@ -0,0 +1,17 @@
+c3/__init__.py,sha256=d3rSgVM3gYEtqlz11gkJY-gNQ3IDd_MO609TxDlOWFk,1431
+c3/billing.py,sha256=zktogvY4XJhJKuQwq0OQcOM_R36rDRJ-jkDwQdkz9qI,2014
+c3/client.py,sha256=hB2JiXNIZu24s5OsPGOrVgbLWt2sNh2VP-bvJxmoVJo,1578
+c3/config.py,sha256=hh3u6-Iewt4nY2gKREOSwRAWl24rmdEYoZvs-Jv_sJs,1998
+c3/files.py,sha256=ipkzs9L1FlgNY_HLdZEGovpfI9Gh4C6yRX4wvE3rbiM,12504
+c3/http.py,sha256=uzxaEI_q1OPv75g56WNCCtPOcmuRsbsrbvvFJrUnyik,7215
+c3/instances.py,sha256=d_zw_JbxL0XPf2kroVtjCK4fjvBx_sBIRMqKP-_kdeQ,7112
+c3/jobs.py,sha256=o1I9cS3QRZiGGw9q-rZ_RwcfTNZxCmRbLdxpb4PxeK8,8307
+c3/logs.py,sha256=tBRIk3ymWcKjEP7EsYVJFZlNRBlZfvEo5JR8mlEVbi4,8956
+c3/renders.py,sha256=rJVS2rP19V1XLX-MBHsM2y_g_fdXnCBErO_oBsZzSTI,11871
+c3/user.py,sha256=Fbzxq64HgDSiP8KyyocKdYVLrTZjFet9LbxCQLhKgDg,830
+c3/job/__init__.py,sha256=q7qh7HyPuYdbMGE-ZPbqN7ss7-irlhLcASNH6K0PllE,448
+c3/job/base.py,sha256=8tvkM1ebhQdNIpFPe6431gkKsCVOLKJXXWQRYB_Iz_g,8529
+c3/job/comfyui.py,sha256=NIcTkCrHMcDxKC5v68Whbgmb0_T8hbYAAGhCRUthjEw,58817
+hypercli_sdk-0.4.2.dist-info/METADATA,sha256=UL5AfalUjQW_vasMH697gfCGeYSPR07FGyrdHx-coys,2970
+hypercli_sdk-0.4.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+hypercli_sdk-0.4.2.dist-info/RECORD,,

hypercli_sdk-0.4.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any