cloudagent 0.3.0

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 CloudAgent

with CloudAgent() as client:                            # reads CLOUDAGENT_API_KEY
    # Companies
    page = client.companies.list(limit=20)
    company = client.companies.create(name="acme", display_name="Acme Inc")

    # Tasks with chief sugar
    result = client.tasks.create(
        company="acme",
        title="Q3 plan",
        brief="figure it out",
        owner="chief",                                  # SDK resolves to CEO agent
    )
    session_id = result["session_id"]
    chief_agent_id = next(
        (s["id"] for s in client.staffs.org_chart("acme")["staffs"] if s.get("is_chief")),
        None,
    )

    # Append a follow-up message to the CEO
    client.sessions.messages.create(
        session_id,
        from_agent="user",
        to_agent=chief_agent_id,
        kind="task",
        content={"text": "and include lost-deal reasons"},
    )

    # Poll for replies
    for item in client.tasks.timeline(result["task"]["id"]).data:
        print(item.get("type"), item.get("content"))

See examples/ for full snippets including error handling.

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.