Metadata-Version: 2.4
Name: agbcloud-sdk
Version: 0.12.0
Summary: AGB Python SDK
Author: AGB Team
License-Expression: Apache-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0
Requires-Dist: certifi>=2024.0.0
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: cryptography>=44.0.0
Requires-Dist: httpx[http2]>=0.28.1
Requires-Dist: pydantic>=2.0
Requires-Dist: playwright>=1.5.0
Requires-Dist: aiohttp>=3.12.5
Requires-Dist: loguru>=0.7.0
Requires-Dist: websockets>=11.0
Provides-Extra: test
Requires-Dist: pytest>=6.2.0; extra == "test"
Requires-Dist: pytest-cov>=2.12.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.25.0; extra == "test"
Provides-Extra: dev
Requires-Dist: black>=21.0.0; extra == "dev"
Requires-Dist: flake8>=3.9.0; extra == "dev"
Requires-Dist: mypy>=0.910; extra == "dev"
Requires-Dist: isort>=5.10.0; extra == "dev"
Requires-Dist: playwright>=1.5.0; extra == "dev"
Requires-Dist: mcp>=1.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: pyyaml>=6.0; extra == "docs"
Requires-Dist: pydoc-markdown>=4.0; extra == "docs"

# AGB Python SDK

Client library for the AGB cloud service: create and manage sessions, run code and commands, use the file system, browser automation, and persistent context.

## Installation

```bash
pip install agbcloud-sdk
```

## Quick Start

```python
from agb import AGB
from agb.session_params import CreateSessionParams

agb = AGB(api_key="your-api-key")
params = CreateSessionParams(image_id="agb-code-space-1")
result = agb.create(params)

if result.success:
    session = result.session
    code_result = session.code.run("print('Hello AGB!')", "python")
    print(code_result.result)
    cmd_result = session.command.execute("ls -la")
    print(cmd_result.output)
    agb.delete(session)
else:
    print(result.error_message)
```

## Features

- Session management (create, list, get, delete)
- **Code** – run Python/JavaScript/Java/R in cloud
- **Command** – execute shell commands
- **File** – read, write, edit, search, transfer
- **Browser** – automation, screenshots, fingerprint
- **Computer** – mouse, keyboard, window, app, screen
- **Context** – persistent data and sync policies

## Documentation

Full docs and API reference: see the [repository documentation](../docs/README.md) (quick start, guides, API reference, examples).

## License

Apache-2.0
