poridhi-cloud 0.3.2

Python SDK for Poridhi Cloud Infrastructure

🌩️ Poridhi Cloud Python SDK

🧠 GPU-backed interactive environments (VSCode & Jupyter) with NVIDIA RTX 4500 — built for AI development and data science

---

🧭 Overview

The Poridhi Cloud Python SDK enables:

• ⚙️ Creating & managing users
• 🧠 Allocating GPU-powered containers for interactive coding
• 🔍 Monitoring session status
• 🧮 Accessing high-performance NVIDIA RTX 4500 for AI/ML tasks

🖥️ Supported Services:

---

📦 Installation

pip install poridhi-cloud

---

🚀 Quick Start

🔐 Initialize the Client

from poridhi_cloud import PoridihCloud

# Option 1: Use environment variable
client = PoridihCloud()

# Option 2: Provide API key directly
client = PoridihCloud(api_key='your-api-key-here')

---

🔧 Features

🧑‍💻 Create a New User

response = client.create_user()
print(response)

---

💻 Get Available Machines

machines = client.get_machineId()
print(machines)

---

🧠 Allocate a GPU Worker

🖥️ Start a VSCode or Jupyter Session

For VSCode port=8080 For Jupyter port = 8888

worker = client.codeserver(
    cpu=2,
    memory=4096,
    gpu='nvidia-rtx-4500',   # Optional (GPU model)
    port=8080,
    serviceType='vscode',    # or 'jupyter'
    duration=3600            # Optional: in seconds
)
print(worker)

💡 Both VSCode and Jupyter sessions run on NVIDIA RTX 4500

---

📶 Check Pod Status

status = client.podStatus(deploymentname='vscode-session-abc123')
print(status)

🔍 Essential for vscode sessions to verify if your pod is active and ready.

---

🔐 Authentication

You can provide your API key via:

1️⃣ Environment Variable

export PORIDHI_CLOUD_API_KEY='your-api-key-here'

2️⃣ Direct in Code

client = PoridihCloud(api_key='your-api-key-here')

---

⚙️ Environment Configuration

Variable Name	Description
PORIDHI_CLOUD_API_KEY	🔐 API key for authentication

---

🚨 Error Handling

from poridhi_cloud import PoridihCloud, PoridihCloudError

try:
    result = client.get_machineId()
except PoridihCloudError as e:
    print(f"Error: {e}")

---

🧪 Full Example Workflow

🎯 Run Complete Session

from poridhi_cloud import PoridihCloud

# Step 1: Initialize
client = PoridihCloud(api_key='your-api-key')

# Step 2: Create user
user = client.create_user()
print("User Created:", user)

# Step 3: List available machines
machines = client.get_machineId()
print("Machines:", machines)

# Step 4: Launch VSCode or Jupyter
worker = client.codeserver(
    cpu=2,
    memory=4096,
    gpu='nvidia-rtx-4500',
    port=8080,
    serviceType='vscode',
    duration=3600
)
print("Worker Allocated:", worker)

# Step 5: Check session status
status = client.podStatus(deploymentname=worker.get('deploymentName'))
print("Pod Status:", status)

---