agentcloudservice 1.0.0

AgentCloudService SDK - Cloud hosting for autonomous AI agents

ACS SDK for Python

Official Python SDK for AgentCloudService - Cloud hosting for autonomous AI agents.

Installation

pip install acs-sdk

Quick Start

from acs_sdk import ACS

# Register a new agent (no auth required)
result = ACS.register(name="my-research-agent")
print(f"API Key: {result.api_key}")

# Create client with API key
client = ACS(api_key=result.api_key)

# Deploy an OpenClaw agent
agent = client.deploy(
    name="research-agent",
    type="openclaw",
    config={
        "model": "claude-sonnet-4",
        "channels": ["telegram", "discord"],
        "skills": ["web_search", "coding"]
    },
    region="us-east-1"
)
print(f"Agent deployed: {agent.url}")

Features

• No CAPTCHA, No Phone Verification - Just API keys and code
• OpenClaw Native - Deploy pre-configured AI agents with channels and skills
• Multiple Deployment Types - OpenClaw, Docker, or serverless functions
• Programmatic Billing - Stripe API or USDC via x402 protocol
• Multi-Region - US, EU, and Asia-Pacific regions

Authentication

from acs_sdk import ACS

# Option 1: Pass API key directly
client = ACS(api_key="acs_live_xxx")

# Option 2: Use environment variable
# export ACS_API_KEY=acs_live_xxx
client = ACS()

API Reference

Registration (No Auth Required)

# Register new agent
result = ACS.register(
    name="my-agent",
    email="[e-mail]",  # Optional
    wallet="0x..."              # Optional, for USDC payments
)
print(result.agent_id)
print(result.api_key)

# Check service status
status = ACS.status()
print(status)

Agent Management

client = ACS(api_key="acs_live_xxx")

# List all agents
agents = client.list_agents()
for agent in agents:
    print(f"{agent.name}: {agent.status}")

# List running agents only
running = client.list_agents(status="running")

# Get specific agent
agent = client.get_agent("agent_xxx")

# Start/stop agent
client.start_agent("agent_xxx")
client.stop_agent("agent_xxx")

# Delete agent
client.delete_agent("agent_xxx")

Deployment

# Deploy OpenClaw agent
agent = client.deploy(
    name="my-agent",
    type="openclaw",
    config={
        "model": "claude-sonnet-4",
        "channels": ["telegram", "discord", "slack"],
        "skills": ["web_search", "coding", "browser"],
        "memory": True
    },
    region="us-east-1"
)

# Deploy Docker container
agent = client.deploy(
    name="custom-agent",
    type="docker",
    config={
        "image": "my-org/my-agent:latest",
        "env": {"API_KEY": "xxx"}
    }
)

# Deploy serverless function
agent = client.deploy(
    name="webhook-handler",
    type="function",
    config={
        "runtime": "python3.11",
        "handler": "main.handler"
    }
)

Usage & Billing

# Get usage metrics
usage = client.get_usage()
print(f"Requests (24h): {usage.requests_24h}")
print(f"Compute used: {usage.compute_used} GB")
print(f"Current bill: ${usage.current_bill}")

# Get billing info
billing = client.get_billing()

# Create checkout session
checkout = client.checkout(plan="micro")
print(f"Checkout URL: {checkout['checkoutUrl']}")

# Pay with USDC
payment = client.pay_usdc(amount="19.00")

Regions

Region	Location
us-east-1	US East (Virginia)
us-west-2	US West (Oregon)
eu-west-1	EU West (Ireland)
eu-central-1	EU Central (Frankfurt)
ap-southeast-1	Asia Pacific (Singapore)
ap-southeast-2	Asia Pacific (Sydney)

Error Handling

from acs_sdk import ACS, ACSError, AuthenticationError, ValidationError

try:
    client = ACS(api_key="invalid")
    agents = client.list_agents()
except AuthenticationError:
    print("Invalid API key")
except ValidationError as e:
    print(f"Validation failed: {e.message}")
except ACSError as e:
    print(f"API error: {e.message} (status: {e.status_code})")

Links

• Documentation
• API Reference
• OpenAPI Spec
• Pricing
• Status

License

MIT License - Copyright (c) 2026 VibeCaaS / NeuralQuantum.ai LLC