runcrate-sdk 0.1.0__tar.gz

runcrate_sdk-0.1.0/.github/workflows/notify-monorepo.yml

@@ -0,0 +1,17 @@
+name: Notify Monorepo
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger monorepo sync
+        run: |
+          curl -X POST \
+            -H "Authorization: token ${{ secrets.MONOREPO_TOKEN }}" \
+            -H "Accept: application/vnd.github.v3+json" \
+            https://api.github.com/repos/aeonmindai/runcrate_app/dispatches \
+            -d '{"event_type":"sdk-updated"}'

runcrate_sdk-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}

runcrate_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: runcrate-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Runcrate API
+Project-URL: Homepage, https://runcrate.ai
+Project-URL: Repository, https://github.com/aeonmindai/runcrate-py
+Project-URL: Documentation, https://runcrate.ai/docs
+Author-email: Runcrate <support@runcrate.ai>
+License-Expression: MIT
+Requires-Python: >=3.9
+Requires-Dist: httpx<1.0,>=0.25.0
+Requires-Dist: pydantic<3.0,>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Runcrate Python SDK
+
+Official Python SDK for the [Runcrate](https://runcrate.ai) API.
+
+## Installation
+
+```bash
+pip install runcrate
+```
+
+## Quick Start
+
+```python
+from runcrate import Runcrate
+
+client = Runcrate(api_key="rc_live_...")
+
+# Chat completion
+response = client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.choices[0].message.content)
+
+# List GPU instances
+instances = client.instances.list()
+
+# Create an instance
+instance = client.instances.create(
+    name="training-run",
+    ssh_key_id="key_abc123",
+    gpu_type="A100",
+)
+
+# Check status
+status = client.instances.get_status(instance.id)
+print(status.status, status.ip)
+
+# Check billing
+balance = client.billing.get_balance()
+print(f"Credits: ${balance.credits_balance}")
+
+client.close()
+```
+
+## Async Usage
+
+```python
+import asyncio
+from runcrate import AsyncRuncrate
+
+async def main():
+    async with AsyncRuncrate(api_key="rc_live_...") as client:
+        response = await client.models.chat_completion(
+            model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+            messages=[{"role": "user", "content": "Hello!"}],
+        )
+        print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+client = Runcrate(
+    api_key="rc_live_...",                        # or set RUNCRATE_API_KEY env var
+    base_url="https://runcrate.ai",               # infra API (default)
+    inference_url="https://api.runcrate.ai",      # model inference API (default)
+    timeout=30.0,                                 # request timeout in seconds
+    max_retries=3,                                # retry on 429/5xx with exponential backoff
+)
+```
+
+## Model Inference
+
+The `client.models` resource connects to `api.runcrate.ai` for AI model inference. Same API key works for both infrastructure and inference.
+
+### Chat Completions
+
+```python
+# Standard request
+response = client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Explain quantum computing in 3 sentences."},
+    ],
+    max_tokens=256,
+    temperature=0.7,
+)
+print(response.choices[0].message.content)
+print(f"Tokens used: {response.usage.total_tokens}")
+
+# Streaming
+for chunk in client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[{"role": "user", "content": "Write a poem about GPUs"}],
+    stream=True,
+):
+    delta = chunk.get("choices", [{}])[0].get("delta", {})
+    print(delta.get("content", ""), end="", flush=True)
+```
+
+### Image Generation
+
+```python
+result = client.models.generate_image(
+    model="black-forest-labs/FLUX.1-schnell",
+    prompt="A futuristic city skyline at sunset",
+    width=1024,
+    height=1024,
+)
+# result.data[0].b64_json contains the base64-encoded image
+```
+
+### Video Generation
+
+```python
+# Submit video job (async processing)
+job = client.models.generate_video(
+    model="google/veo-3.0",
+    prompt="A drone flyover of a mountain landscape",
+    duration=8,
+)
+print(f"Job ID: {job.id}, Status: {job.status}")
+
+# Poll until complete
+import time
+while True:
+    job = client.models.get_video_status(job.id)
+    print(f"Status: {job.status}")
+    if job.status in ("completed", "failed"):
+        break
+    time.sleep(5)
+
+# Download the video
+if job.status == "completed":
+    video_bytes = client.models.download_video(job.id)
+    with open("output.mp4", "wb") as f:
+        f.write(video_bytes)
+```
+
+### Text-to-Speech
+
+```python
+audio_bytes = client.models.text_to_speech(
+    model="openai/tts-1",
+    input="Hello, welcome to Runcrate!",
+    voice="alloy",
+    response_format="mp3",
+)
+with open("speech.mp3", "wb") as f:
+    f.write(audio_bytes)
+```
+
+### Transcription (Speech-to-Text)
+
+```python
+with open("audio.wav", "rb") as f:
+    result = client.models.transcribe(
+        model="openai/whisper-1",
+        file=f,
+        filename="audio.wav",
+    )
+print(result.text)
+print(f"Duration: {result.duration}s")
+```
+
+## Infrastructure Resources
+
+### Instances
+
+```python
+client.instances.list(search="my-gpu")
+client.instances.create(name="run", ssh_key_id="key", gpu_type="A100")
+client.instances.get("instance-id")
+client.instances.terminate("instance-id")
+client.instances.get_status("instance-id")
+client.instances.list_types(gpu_type="A100", region="us-east")
+```
+
+### Environments
+
+```python
+client.environments.list()
+client.environments.create(name="staging")
+client.environments.get("env-id")
+client.environments.update("env-id", name="production")
+client.environments.delete("env-id")
+```
+
+### SSH Keys
+
+```python
+client.ssh_keys.list()
+client.ssh_keys.create(name="my-key", public_key="ssh-ed25519 AAAA...")
+client.ssh_keys.delete("key-id")
+```
+
+### Storage
+
+```python
+client.storage.list()
+client.storage.get("volume-id")
+```
+
+### Billing
+
+```python
+client.billing.get_balance()
+client.billing.list_transactions(limit=10, offset=0)
+client.billing.usage(from_date="2025-01-01", to_date="2025-01-31")
+```
+
+### Templates
+
+```python
+client.templates.list(search="cuda", category="ml", page_size=10)
+```
+
+## Error Handling
+
+```python
+from runcrate import Runcrate, NotFoundError, InsufficientCreditsError, RateLimitError
+
+client = Runcrate(api_key="rc_live_...")
+
+try:
+    instance = client.instances.get("nonexistent")
+except NotFoundError as e:
+    print(f"Not found: {e.message}")
+except InsufficientCreditsError as e:
+    print(f"Need more credits: {e.message}")
+except RateLimitError as e:
+    print(f"Rate limited: {e.message}")
+```
+
+## Pagination
+
+```python
+# Transactions support offset-based pagination
+page = client.billing.list_transactions(limit=10, offset=0)
+print(page.data)        # list of Transaction objects
+print(page.has_more)    # True if more pages exist
+print(page.total)       # total count
+
+# Templates support page-based pagination
+templates = client.templates.list(page=1, page_size=25)
+```
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+- pydantic >= 2.0

runcrate_sdk-0.1.0/README.md

@@ -0,0 +1,256 @@
+# Runcrate Python SDK
+
+Official Python SDK for the [Runcrate](https://runcrate.ai) API.
+
+## Installation
+
+```bash
+pip install runcrate
+```
+
+## Quick Start
+
+```python
+from runcrate import Runcrate
+
+client = Runcrate(api_key="rc_live_...")
+
+# Chat completion
+response = client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+print(response.choices[0].message.content)
+
+# List GPU instances
+instances = client.instances.list()
+
+# Create an instance
+instance = client.instances.create(
+    name="training-run",
+    ssh_key_id="key_abc123",
+    gpu_type="A100",
+)
+
+# Check status
+status = client.instances.get_status(instance.id)
+print(status.status, status.ip)
+
+# Check billing
+balance = client.billing.get_balance()
+print(f"Credits: ${balance.credits_balance}")
+
+client.close()
+```
+
+## Async Usage
+
+```python
+import asyncio
+from runcrate import AsyncRuncrate
+
+async def main():
+    async with AsyncRuncrate(api_key="rc_live_...") as client:
+        response = await client.models.chat_completion(
+            model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+            messages=[{"role": "user", "content": "Hello!"}],
+        )
+        print(response.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+client = Runcrate(
+    api_key="rc_live_...",                        # or set RUNCRATE_API_KEY env var
+    base_url="https://runcrate.ai",               # infra API (default)
+    inference_url="https://api.runcrate.ai",      # model inference API (default)
+    timeout=30.0,                                 # request timeout in seconds
+    max_retries=3,                                # retry on 429/5xx with exponential backoff
+)
+```
+
+## Model Inference
+
+The `client.models` resource connects to `api.runcrate.ai` for AI model inference. Same API key works for both infrastructure and inference.
+
+### Chat Completions
+
+```python
+# Standard request
+response = client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant."},
+        {"role": "user", "content": "Explain quantum computing in 3 sentences."},
+    ],
+    max_tokens=256,
+    temperature=0.7,
+)
+print(response.choices[0].message.content)
+print(f"Tokens used: {response.usage.total_tokens}")
+
+# Streaming
+for chunk in client.models.chat_completion(
+    model="meta-llama/Meta-Llama-3.1-8B-Instruct",
+    messages=[{"role": "user", "content": "Write a poem about GPUs"}],
+    stream=True,
+):
+    delta = chunk.get("choices", [{}])[0].get("delta", {})
+    print(delta.get("content", ""), end="", flush=True)
+```
+
+### Image Generation
+
+```python
+result = client.models.generate_image(
+    model="black-forest-labs/FLUX.1-schnell",
+    prompt="A futuristic city skyline at sunset",
+    width=1024,
+    height=1024,
+)
+# result.data[0].b64_json contains the base64-encoded image
+```
+
+### Video Generation
+
+```python
+# Submit video job (async processing)
+job = client.models.generate_video(
+    model="google/veo-3.0",
+    prompt="A drone flyover of a mountain landscape",
+    duration=8,
+)
+print(f"Job ID: {job.id}, Status: {job.status}")
+
+# Poll until complete
+import time
+while True:
+    job = client.models.get_video_status(job.id)
+    print(f"Status: {job.status}")
+    if job.status in ("completed", "failed"):
+        break
+    time.sleep(5)
+
+# Download the video
+if job.status == "completed":
+    video_bytes = client.models.download_video(job.id)
+    with open("output.mp4", "wb") as f:
+        f.write(video_bytes)
+```
+
+### Text-to-Speech
+
+```python
+audio_bytes = client.models.text_to_speech(
+    model="openai/tts-1",
+    input="Hello, welcome to Runcrate!",
+    voice="alloy",
+    response_format="mp3",
+)
+with open("speech.mp3", "wb") as f:
+    f.write(audio_bytes)
+```
+
+### Transcription (Speech-to-Text)
+
+```python
+with open("audio.wav", "rb") as f:
+    result = client.models.transcribe(
+        model="openai/whisper-1",
+        file=f,
+        filename="audio.wav",
+    )
+print(result.text)
+print(f"Duration: {result.duration}s")
+```
+
+## Infrastructure Resources
+
+### Instances
+
+```python
+client.instances.list(search="my-gpu")
+client.instances.create(name="run", ssh_key_id="key", gpu_type="A100")
+client.instances.get("instance-id")
+client.instances.terminate("instance-id")
+client.instances.get_status("instance-id")
+client.instances.list_types(gpu_type="A100", region="us-east")
+```
+
+### Environments
+
+```python
+client.environments.list()
+client.environments.create(name="staging")
+client.environments.get("env-id")
+client.environments.update("env-id", name="production")
+client.environments.delete("env-id")
+```
+
+### SSH Keys
+
+```python
+client.ssh_keys.list()
+client.ssh_keys.create(name="my-key", public_key="ssh-ed25519 AAAA...")
+client.ssh_keys.delete("key-id")
+```
+
+### Storage
+
+```python
+client.storage.list()
+client.storage.get("volume-id")
+```
+
+### Billing
+
+```python
+client.billing.get_balance()
+client.billing.list_transactions(limit=10, offset=0)
+client.billing.usage(from_date="2025-01-01", to_date="2025-01-31")
+```
+
+### Templates
+
+```python
+client.templates.list(search="cuda", category="ml", page_size=10)
+```
+
+## Error Handling
+
+```python
+from runcrate import Runcrate, NotFoundError, InsufficientCreditsError, RateLimitError
+
+client = Runcrate(api_key="rc_live_...")
+
+try:
+    instance = client.instances.get("nonexistent")
+except NotFoundError as e:
+    print(f"Not found: {e.message}")
+except InsufficientCreditsError as e:
+    print(f"Need more credits: {e.message}")
+except RateLimitError as e:
+    print(f"Rate limited: {e.message}")
+```
+
+## Pagination
+
+```python
+# Transactions support offset-based pagination
+page = client.billing.list_transactions(limit=10, offset=0)
+print(page.data)        # list of Transaction objects
+print(page.has_more)    # True if more pages exist
+print(page.total)       # total count
+
+# Templates support page-based pagination
+templates = client.templates.list(page=1, page_size=25)
+```
+
+## Requirements
+
+- Python >= 3.9
+- httpx >= 0.25.0
+- pydantic >= 2.0

runcrate_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runcrate-sdk"
+version = "0.1.0"
+description = "Official Python SDK for the Runcrate API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Runcrate", email = "support@runcrate.ai" }
+]
+dependencies = [
+    "httpx>=0.25.0,<1.0",
+    "pydantic>=2.0,<3.0",
+]
+
+[project.urls]
+Homepage = "https://runcrate.ai"
+Repository = "https://github.com/aeonmindai/runcrate-py"
+Documentation = "https://runcrate.ai/docs"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "respx>=0.21",
+    "ruff>=0.4",
+    "mypy>=1.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runcrate"]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.mypy]
+strict = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

runcrate_sdk-0.1.0/src/runcrate/__init__.py

@@ -0,0 +1,44 @@
+"""Runcrate Python SDK — Official client for the Runcrate API."""
+
+from runcrate._client import AsyncRuncrate, Runcrate
+from runcrate._exceptions import (
+    ApiError,
+    AuthenticationError,
+    BadRequestError,
+    ConflictError,
+    UnprocessableEntityError,
+    ConnectionError,
+    InsufficientCreditsError,
+    InternalServerError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    RuncrateError,
+    TimeoutError,
+)
+from runcrate._pagination import PaginatedResponse
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AsyncRuncrate",
+    "Runcrate",
+    # Exceptions
+    "ApiError",
+    "AuthenticationError",
+    "BadRequestError",
+    "ConflictError",
+    "UnprocessableEntityError",
+    "ConnectionError",
+    "InsufficientCreditsError",
+    "InternalServerError",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "RateLimitError",
+    "RuncrateError",
+    "TimeoutError",
+    # Pagination
+    "PaginatedResponse",
+    # Version
+    "__version__",
+]