hypercli-sdk 0.4.2__tar.gz

hypercli_sdk-0.4.2/.gitignore

@@ -0,0 +1,51 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+.venv/
+*.egg-info/
+
+# Build outputs
+.next
+out
+dist
+build
+
+# Testing
+coverage
+
+# Misc
+.DS_Store
+*.pem
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Vercel
+.vercel
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
+# Turbo
+.turbo

hypercli_sdk-0.4.2/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,114 @@
+# 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/c3/__init__.py

@@ -0,0 +1,57 @@
+"""C3 SDK - Python client for HyperCLI API"""
+from .client import C3
+from .config import configure, GHCR_IMAGES, COMFYUI_IMAGE
+from .http import APIError, AsyncHTTPClient
+from .instances import GPUType, GPUConfig, Region, GPUPricing, PricingTier
+from .jobs import Job, JobMetrics, GPUMetrics, find_job, find_by_id, find_by_hostname, find_by_ip
+from .renders import Render, RenderStatus
+from .files import File, AsyncFiles
+from .job import BaseJob, ComfyUIJob, apply_params, apply_graph_modes, find_node, find_nodes, load_template, graph_to_api, DEFAULT_OBJECT_INFO
+from .logs import LogStream, stream_logs, fetch_logs
+
+__version__ = "0.2.1"
+__all__ = [
+    "C3",
+    "configure",
+    "APIError",
+    # Images
+    "GHCR_IMAGES",
+    "COMFYUI_IMAGE",
+    # Instance types
+    "GPUType",
+    "GPUConfig",
+    "Region",
+    "GPUPricing",
+    "PricingTier",
+    # Jobs API
+    "Job",
+    "JobMetrics",
+    "GPUMetrics",
+    # Renders API
+    "Render",
+    "RenderStatus",
+    # Files API
+    "File",
+    "AsyncFiles",
+    "AsyncHTTPClient",
+    # Job lookup utils
+    "find_job",
+    "find_by_id",
+    "find_by_hostname",
+    "find_by_ip",
+    # Job helpers
+    "BaseJob",
+    "ComfyUIJob",
+    # Workflow utils
+    "apply_params",
+    "apply_graph_modes",
+    "find_node",
+    "find_nodes",
+    "load_template",
+    "graph_to_api",
+    "DEFAULT_OBJECT_INFO",
+    # Log streaming
+    "LogStream",
+    "stream_logs",
+    "fetch_logs",
+]

hypercli_sdk-0.4.2/c3/billing.py

@@ -0,0 +1,72 @@
+"""Billing API"""
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .http import HTTPClient
+
+
+@dataclass
+class Balance:
+    total: str
+    rewards: str
+    paid: str
+    available: str
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Balance":
+        return cls(
+            total=data.get("total_balance", "0"),
+            rewards=data.get("rewards_balance", "0"),
+            paid=data.get("balance", "0"),
+            available=data.get("available_balance", "0"),
+        )
+
+
+@dataclass
+class Transaction:
+    id: str
+    user_id: str
+    amount: int
+    amount_usd: float
+    transaction_type: str
+    status: str
+    rewards: bool
+    job_id: str | None
+    created_at: str
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Transaction":
+        return cls(
+            id=data.get("id", ""),
+            user_id=data.get("user_id", ""),
+            amount=data.get("amount", 0),
+            amount_usd=data.get("amount_usd", 0),
+            transaction_type=data.get("transaction_type", ""),
+            status=data.get("status", ""),
+            rewards=data.get("rewards", False),
+            job_id=data.get("job_id"),
+            created_at=data.get("created_at", ""),
+        )
+
+
+class Billing:
+    """Billing API wrapper"""
+
+    def __init__(self, http: "HTTPClient"):
+        self._http = http
+
+    def balance(self) -> Balance:
+        """Get account balance"""
+        data = self._http.get("/api/balance")
+        return Balance.from_dict(data)
+
+    def transactions(self, limit: int = 50, page: int = 1) -> list[Transaction]:
+        """List transactions"""
+        data = self._http.get("/api/tx", params={"page": page, "page_size": limit})
+        return [Transaction.from_dict(tx) for tx in data.get("transactions", [])]
+
+    def get_transaction(self, transaction_id: str) -> Transaction:
+        """Get a specific transaction"""
+        data = self._http.get(f"/api/tx/{transaction_id}")
+        return Transaction.from_dict(data)

hypercli_sdk-0.4.2/c3/client.py

@@ -0,0 +1,60 @@
+"""Main C3 client"""
+from .config import get_api_key, get_api_url
+from .http import HTTPClient
+from .billing import Billing
+from .jobs import Jobs
+from .user import UserAPI
+from .instances import Instances
+from .renders import Renders
+from .files import Files
+
+
+class C3:
+    """
+    C3 API Client
+
+    Usage:
+        from c3 import C3
+
+        c3 = C3()  # Uses C3_API_KEY from env or ~/.c3/config
+        # or
+        c3 = C3(api_key="your_key")
+
+        # Billing
+        balance = c3.billing.balance()
+        print(f"Balance: ${balance.total}")
+
+        # Jobs
+        job = c3.jobs.create(
+            image="nvidia/cuda:12.0",
+            gpu_type="l40s",
+            command="python train.py"
+        )
+        print(f"Job: {job.job_id}")
+
+        # User
+        user = c3.user.get()
+    """
+
+    def __init__(self, api_key: str = None, api_url: str = None):
+        self._api_key = api_key or get_api_key()
+        if not self._api_key:
+            raise ValueError(
+                "API key required. Set C3_API_KEY env var, "
+                "create ~/.c3/config, or pass api_key parameter."
+            )
+
+        self._api_url = api_url or get_api_url()
+        self._http = HTTPClient(self._api_url, self._api_key)
+
+        # API namespaces
+        self.billing = Billing(self._http)
+        self.jobs = Jobs(self._http)
+        self.user = UserAPI(self._http)
+        self.instances = Instances(self._http)
+        self.renders = Renders(self._http)
+        self.files = Files(self._http)
+
+    @property
+    def api_url(self) -> str:
+        return self._api_url

hypercli_sdk-0.4.2/c3/config.py

@@ -0,0 +1,70 @@
+"""Configuration handling"""
+import os
+from pathlib import Path
+from typing import Optional
+
+CONFIG_DIR = Path.home() / ".c3"
+CONFIG_FILE = CONFIG_DIR / "config"
+
+DEFAULT_API_URL = "https://api.hypercli.com"
+DEFAULT_WS_URL = "wss://api.hypercli.com"
+WS_LOGS_PATH = "/orchestra/ws/logs"  # WebSocket path for job logs: {WS_URL}{WS_LOGS_PATH}/{job_key}
+
+# GHCR images
+GHCR_IMAGES = "ghcr.io/hypercliai/images"
+COMFYUI_IMAGE = f"{GHCR_IMAGES}/comfyui"
+
+
+def _load_config_file() -> dict:
+    """Load config from ~/.c3/config"""
+    config = {}
+    if CONFIG_FILE.exists():
+        for line in CONFIG_FILE.read_text().splitlines():
+            line = line.strip()
+            if line and not line.startswith("#") and "=" in line:
+                key, value = line.split("=", 1)
+                config[key.strip()] = value.strip()
+    return config
+
+
+def get_config_value(key: str, default: str = None) -> Optional[str]:
+    """Get config value: env var > config file > default"""
+    env_val = os.getenv(key)
+    if env_val:
+        return env_val
+    config = _load_config_file()
+    return config.get(key, default)
+
+
+def get_api_key() -> Optional[str]:
+    """Get API key from env or config file"""
+    return get_config_value("C3_API_KEY")
+
+
+def get_api_url() -> str:
+    """Get API URL"""
+    return get_config_value("C3_API_URL", DEFAULT_API_URL)
+
+
+def get_ws_url() -> str:
+    """Get WebSocket URL"""
+    ws = get_config_value("C3_WS_URL")
+    if ws:
+        return ws
+    # Derive from API URL
+    api = get_api_url()
+    return api.replace("https://", "wss://").replace("http://", "ws://")
+
+
+def configure(api_key: str, api_url: str = None):
+    """Save configuration to ~/.c3/config"""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+
+    config = _load_config_file()
+    config["C3_API_KEY"] = api_key
+    if api_url:
+        config["C3_API_URL"] = api_url
+
+    lines = [f"{k}={v}" for k, v in config.items()]
+    CONFIG_FILE.write_text("\n".join(lines) + "\n")
+    CONFIG_FILE.chmod(0o600)