Metadata-Version: 2.4
Name: cloudagent
Version: 0.2.1
Summary: CloudAgent Python SDK and CLI — Anthropic Managed Agents compatible platform
Project-URL: Homepage, https://cloudagent.chat
Project-URL: Documentation, https://cloudagent.chat/docs
Project-URL: Changelog, https://pypi.org/project/cloudagent/#history
Author: CloudAgent
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,anthropic,cli,cloudagent,llm,managed-agents,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# 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

```bash
pip install cloudagent
```

Requires Python 3.10+.

## Quickstart — CLI

```bash
# 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

```python
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](./LICENSE).
