hypercli-cli 0.4.0__tar.gz

hypercli_cli-0.4.0/.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_cli-0.4.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: hypercli-cli
+Version: 0.4.0
+Summary: CLI for HyperCLI - GPU orchestration and LLM API
+Project-URL: Homepage, https://hypercli.com
+Project-URL: Documentation, https://docs.hypercli.com
+Author-email: HyperCLI <support@hypercli.com>
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: hypercli-sdk[comfyui]>=0.4.0
+Requires-Dist: openai>=2.8.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: typer>=0.20.0
+Requires-Dist: websocket-client>=1.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# C3 CLI
+
+Command-line interface for [HyperCLI](https://hypercli.com) - GPU orchestration and LLM API.
+
+## Installation
+
+```bash
+pip install c3-cli
+```
+
+This also installs the `c3-sdk` as a dependency.
+
+## Setup
+
+Configure your API key:
+
+```bash
+c3 configure
+```
+
+Or set via environment:
+
+```bash
+export C3_API_KEY=your_key
+```
+
+Or create `~/.c3/config`:
+
+```
+C3_API_KEY=your_key
+```
+
+Get your API key at [hypercli.com/dashboard](https://hypercli.com/dashboard)
+
+## Usage
+
+### Billing
+
+```bash
+c3 billing balance
+c3 billing transactions
+c3 billing balance -o json
+```
+
+### LLM
+
+```bash
+# List models
+c3 llm models
+
+# Quick chat
+c3 llm chat deepseek-v3.1 "Explain quantum computing"
+
+# Interactive chat
+c3 llm chat deepseek-v3.1
+
+# With system prompt
+c3 llm chat deepseek-v3.1 "Write a haiku" -s "You are a poet"
+```
+
+### Jobs
+
+```bash
+# List jobs
+c3 jobs list
+c3 jobs list -s running
+
+# Create a job
+c3 jobs create nvidia/cuda:12.0 -g l40s -c "python train.py"
+
+# Create and follow logs with TUI
+c3 jobs create nvidia/cuda:12.0 -g h100 -n 8 -c "torchrun train.py" -f
+
+# Get job details
+c3 jobs get <job_id>
+
+# Stream logs
+c3 jobs logs <job_id> -f
+
+# Watch GPU metrics
+c3 jobs metrics <job_id> -w
+
+# Cancel
+c3 jobs cancel <job_id>
+
+# Extend runtime
+c3 jobs extend <job_id> 7200
+```
+
+### User
+
+```bash
+c3 user
+```
+
+## Output Formats
+
+```bash
+c3 jobs list -o json
+c3 billing balance -o table
+```
+
+## License
+
+MIT

hypercli_cli-0.4.0/README.md

@@ -0,0 +1,105 @@
+# C3 CLI
+
+Command-line interface for [HyperCLI](https://hypercli.com) - GPU orchestration and LLM API.
+
+## Installation
+
+```bash
+pip install c3-cli
+```
+
+This also installs the `c3-sdk` as a dependency.
+
+## Setup
+
+Configure your API key:
+
+```bash
+c3 configure
+```
+
+Or set via environment:
+
+```bash
+export C3_API_KEY=your_key
+```
+
+Or create `~/.c3/config`:
+
+```
+C3_API_KEY=your_key
+```
+
+Get your API key at [hypercli.com/dashboard](https://hypercli.com/dashboard)
+
+## Usage
+
+### Billing
+
+```bash
+c3 billing balance
+c3 billing transactions
+c3 billing balance -o json
+```
+
+### LLM
+
+```bash
+# List models
+c3 llm models
+
+# Quick chat
+c3 llm chat deepseek-v3.1 "Explain quantum computing"
+
+# Interactive chat
+c3 llm chat deepseek-v3.1
+
+# With system prompt
+c3 llm chat deepseek-v3.1 "Write a haiku" -s "You are a poet"
+```
+
+### Jobs
+
+```bash
+# List jobs
+c3 jobs list
+c3 jobs list -s running
+
+# Create a job
+c3 jobs create nvidia/cuda:12.0 -g l40s -c "python train.py"
+
+# Create and follow logs with TUI
+c3 jobs create nvidia/cuda:12.0 -g h100 -n 8 -c "torchrun train.py" -f
+
+# Get job details
+c3 jobs get <job_id>
+
+# Stream logs
+c3 jobs logs <job_id> -f
+
+# Watch GPU metrics
+c3 jobs metrics <job_id> -w
+
+# Cancel
+c3 jobs cancel <job_id>
+
+# Extend runtime
+c3 jobs extend <job_id> 7200
+```
+
+### User
+
+```bash
+c3 user
+```
+
+## Output Formats
+
+```bash
+c3 jobs list -o json
+c3 billing balance -o table
+```
+
+## License
+
+MIT

hypercli_cli-0.4.0/c3cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

hypercli_cli-0.4.0/c3cli/billing.py

@@ -0,0 +1,60 @@
+"""c3 billing commands"""
+import typer
+from c3 import C3
+from .output import output, console, spinner
+
+app = typer.Typer(help="Billing and balance commands")
+
+
+def get_client() -> C3:
+    return C3()
+
+
+@app.command("balance")
+def balance(
+    fmt: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+):
+    """Get account balance"""
+    c3 = get_client()
+    with spinner("Fetching balance..."):
+        bal = c3.billing.balance()
+
+    if fmt == "table":
+        console.print()
+        console.print("[bold]Account Balance[/bold]")
+        console.print()
+        console.print(f"  Balance:   [bold green]${bal.total}[/bold green]")
+        console.print(f"  Available: ${bal.available}")
+        if bal.rewards != "0.000000" and bal.rewards != "0":
+            console.print(f"  [dim](Rewards: ${bal.rewards})[/dim]")
+        console.print()
+    else:
+        output(bal, fmt)
+
+
+@app.command("transactions")
+def transactions(
+    limit: int = typer.Option(20, "--limit", "-n", help="Number of transactions"),
+    page: int = typer.Option(1, "--page", "-p", help="Page number"),
+    fmt: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+):
+    """List transactions"""
+    c3 = get_client()
+    with spinner("Fetching transactions..."):
+        txs = c3.billing.transactions(limit=limit, page=page)
+
+    if fmt == "json":
+        output(txs, fmt)
+    else:
+        output(txs, "table", ["id", "transaction_type", "amount_usd", "status", "created_at"])
+
+
+@app.command("invoices")
+def invoices(
+    limit: int = typer.Option(20, "--limit", "-n", help="Number of invoices"),
+    fmt: str = typer.Option("table", "--output", "-o", help="Output format: table|json"),
+):
+    """List invoices"""
+    c3 = get_client()
+    # TODO: Add invoices to SDK
+    console.print("[dim]Invoices endpoint not yet implemented in SDK[/dim]")

hypercli_cli-0.4.0/c3cli/cli.py

@@ -0,0 +1,183 @@
+"""C3 CLI - Main entry point"""
+import sys
+import typer
+from rich.console import Console
+from rich.prompt import Prompt
+
+from c3 import C3, APIError, configure
+from c3.config import CONFIG_FILE
+
+from . import billing, comfyui, instances, jobs, llm, renders, user
+
+console = Console()
+
+
+def fuzzy_match(input_str: str, options: list[str], threshold: float = 0.5) -> list[str]:
+    """Find similar strings using multiple heuristics"""
+    def similarity(a: str, b: str) -> float:
+        a, b = a.lower(), b.lower()
+        if a == b:
+            return 1.0
+
+        # Exact substring match
+        if a in b or b in a:
+            return 0.9
+
+        # Same characters (handles transpositions like rtx6000pro vs rtxpro6000)
+        if sorted(a) == sorted(b):
+            return 0.95
+
+        # Character set overlap
+        set_a, set_b = set(a), set(b)
+        common = set_a & set_b
+        jaccard = len(common) / len(set_a | set_b) if set_a | set_b else 0
+
+        # Prefix match bonus
+        prefix_len = 0
+        for ca, cb in zip(a, b):
+            if ca == cb:
+                prefix_len += 1
+            else:
+                break
+        prefix_bonus = prefix_len / max(len(a), len(b)) * 0.3
+
+        return jaccard + prefix_bonus
+
+    matches = [(opt, similarity(input_str, opt)) for opt in options]
+    matches = [(opt, score) for opt, score in matches if score >= threshold]
+    matches.sort(key=lambda x: x[1], reverse=True)
+    return [opt for opt, _ in matches[:3]]
+
+app = typer.Typer(
+    name="c3",
+    help="HyperCLI CLI - GPU orchestration and LLM API",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+
+# Register subcommands
+app.add_typer(billing.app, name="billing")
+app.add_typer(comfyui.app, name="comfyui")
+app.add_typer(instances.app, name="instances")
+app.add_typer(jobs.app, name="jobs")
+app.add_typer(llm.app, name="llm")
+app.add_typer(renders.app, name="renders")
+app.add_typer(user.app, name="user")
+
+
+@app.command("configure")
+def configure_cmd():
+    """Configure C3 CLI with your API key and API URL"""
+    import getpass
+    from c3.config import get_api_key, get_api_url, DEFAULT_API_URL
+
+    console.print("\n[bold cyan]C3 CLI Configuration[/bold cyan]\n")
+
+    # Show current config
+    current_key = get_api_key()
+    current_url = get_api_url()
+
+    if current_key:
+        key_preview = current_key[:4] + "..." + current_key[-4:] if len(current_key) > 8 else "****"
+        console.print(f"Current API key: [dim]{key_preview}[/dim]")
+    if current_url and current_url != DEFAULT_API_URL:
+        console.print(f"Current API URL: [dim]{current_url}[/dim]")
+
+    console.print()
+    console.print("Get your API key at [link=https://hypercli.com/dashboard]hypercli.com/dashboard[/link]\n")
+
+    # API Key
+    api_key = getpass.getpass("API key (enter to keep current): ") if current_key else getpass.getpass("API key: ")
+    api_key = api_key.strip() if api_key else None
+
+    if not api_key and not current_key:
+        console.print("[red]No API key provided[/red]")
+        raise typer.Exit(1)
+
+    # API URL
+    url_prompt = f"API URL (enter for default, current: {current_url}): " if current_url != DEFAULT_API_URL else "API URL (enter for default): "
+    api_url = Prompt.ask(url_prompt, default="")
+    api_url = api_url.strip() if api_url else None
+
+    # Only update what changed
+    final_key = api_key or current_key
+    final_url = api_url if api_url else (current_url if current_url != DEFAULT_API_URL else None)
+
+    configure(final_key, final_url)
+
+    console.print(f"\n[green]✓[/green] Config saved to {CONFIG_FILE}")
+    if api_key:
+        preview = api_key[:4] + "..." + api_key[-4:] if len(api_key) > 8 else "****"
+        console.print(f"  API key: {preview}")
+    if final_url:
+        console.print(f"  API URL: {final_url}")
+    console.print("\nTest your setup with: [cyan]c3 billing balance[/cyan]\n")
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(False, "--version", "-v", help="Show version"),
+):
+    """
+    [bold cyan]C3 CLI[/bold cyan] - HyperCLI GPU orchestration and LLM API
+
+    Set your API key: [green]c3 configure[/green]
+
+    Get started:
+        c3 instances list      Browse available GPUs
+        c3 instances launch    Launch a GPU instance
+        c3 jobs list           View your running jobs
+        c3 llm chat -i         Start a chat
+    """
+    if version:
+        from . import __version__
+        console.print(f"c3 version {__version__}")
+        raise typer.Exit()
+
+
+def cli():
+    """Entry point with error handling"""
+    try:
+        app()
+    except APIError as e:
+        detail = e.detail or str(e)
+
+        # Check for GPU type errors and suggest corrections
+        if "GPU type" in detail and "not found" in detail and "Available:" in detail:
+            # Extract the invalid GPU type and available options
+            import re
+            match = re.search(r"GPU type '([^']+)' not found\. Available: \[([^\]]+)\]", detail)
+            if match:
+                invalid_type = match.group(1)
+                available_str = match.group(2)
+                available = [s.strip().strip("'") for s in available_str.split(",")]
+
+                console.print(f"[bold red]Error:[/bold red] Unknown GPU type '[yellow]{invalid_type}[/yellow]'")
+
+                # Find similar GPU types
+                suggestions = fuzzy_match(invalid_type, available)
+                if suggestions:
+                    console.print(f"\n[dim]Did you mean:[/dim]")
+                    for s in suggestions:
+                        console.print(f"  [green]{s}[/green]")
+
+                console.print(f"\n[dim]Available GPU types:[/dim] {', '.join(available)}")
+                sys.exit(1)
+
+        # Check for region errors
+        if "region" in detail.lower() and "not found" in detail.lower():
+            console.print(f"[bold red]Error:[/bold red] {detail}")
+            console.print("\n[dim]Tip: Use 'c3 jobs regions' to see available regions[/dim]")
+            sys.exit(1)
+
+        # Generic API error
+        console.print(f"[bold red]API Error ({e.status_code}):[/bold red] {detail}")
+        sys.exit(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[dim]Interrupted[/dim]")
+        sys.exit(130)
+
+
+if __name__ == "__main__":
+    cli()