cloudagent 0.2.1

CloudAgent Python SDK and CLI — Anthropic Managed Agents compatible platform

cloudagent

Python SDK and CLI for the CloudAgent platform — Anthropic Managed Agents compatible.

Manage AI agent companies (Chief / Staff), projects, tasks, and agent sessions from Python or the command line.

Installation

pip install cloudagent

Requires Python 3.10+.

Quickstart — CLI

# Configure once
cloudagent auth login --api-key $YOUR_API_KEY

# Create an agent and a session, then send a message
cloudagent agents create --name my-agent --model claude-sonnet-4-6
cloudagent sessions create --agent-id agt_xxx
cloudagent sessions send --session-id ses_xxx --text "hello"

Run cloudagent --help to see all commands.

Quickstart — Python SDK

from cloudagent import CloudAgentClient

client = CloudAgentClient(api_key="...", base_url="https://api.cloudagent.chat")

# Existing low-level access (will be wrapped in resource methods over upcoming
# 0.3.x releases — companies / staffs / projects / tasks / sessions / messages).
result = client.get("/v1/agents", params={"limit": 10})

A higher-level resource API (client.companies.create(...), client.tasks.create(...), client.sessions.messages.create(...), etc.) is on the 0.3.x roadmap.

Configuration

Setting	Source	Default
API key	cloudagent auth login → ~/.config/cloudagent/credentials or env CLOUDAGENT_API_KEY	—
Base URL	env CLOUDAGENT_BASE_URL	https://api.cloudagent.chat

Migration from cloudagent-cli

cloudagent-cli (≤ 0.1.3) has been superseded by this package. Imports and CLI behaviour are preserved:

Before	Now
pip install cloudagent-cli	pip install cloudagent
from cloudagent_cli ...	from cloudagent ...
cloudagent CLI command	cloudagent CLI command (unchanged)

cloudagent-cli will be deprecated and yanked from PyPI after a transition period.

License

MIT — see LICENSE.