cloman 0.1.0

Official Python SDK for the CloMan API

CloMan Python SDK

Official Python client for the CloMan API — query your AI clones programmatically.

Installation

pip install cloman

Quick Start

from cloman import CloMan

client = CloMan(api_key="cloman_...")
result = client.decide(context="Should we approve this refund request?")

print(result.decision)       # "approve" / "deny" / ...
print(result.confidence)     # 0.92
print(result.reasoning)      # "Based on the refund policy..."

Async Usage

from cloman import AsyncCloMan

async with AsyncCloMan(api_key="cloman_...") as client:
    result = await client.decide(
        context="Should we approve this refund request?",
        action_type="approval",
        data={"amount": 49.99, "reason": "defective"},
    )
    print(result.decision)

Configuration

client = CloMan(
    api_key="cloman_...",
    base_url="https://api.cloman.app",  # default; override for self-hosted
    timeout=30.0,                        # request timeout in seconds
    max_retries=3,                       # retries on 5xx errors
)

Error Handling

from cloman import CloMan
from cloman.errors import AuthenticationError, RateLimitError

client = CloMan(api_key="cloman_...")
try:
    result = client.decide(context="...")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited: {e.message}")

Requirements

• Python 3.9+
• httpx (installed automatically)

Documentation

Full documentation: docs.viwoapp.io

License

MIT