agbcloud-sdk 0.10.0

AGB Python SDK

AGB Python SDK

---

🔥 Moltbot (formerly Clawdbot) Quick Deployment

You can use AGB SDK to spin up a prebuilt Moltbot cloud desktop in minutes, then open the Moltbot console inside the desktop browser.

• Cookbook (Discord): docs/examples/openclaw/openclaw_discord_config_example.py — create session, run openclaw config (Bailian/Discord), and get the cloud desktop URL.
• Cookbook (Slack): docs/examples/openclaw/openclaw_slack_config_example.py — create session, run openclaw config (Bailian/Slack), and get the cloud desktop URL.
• Cookbook (Telegram): docs/examples/openclaw/openclaw_telegram_config_example.py — create session, run openclaw config (Bailian/Telegram), and get the cloud desktop URL.
• Cloud Desktop URL: The example prints session.resource_url and pauses for hands-on exploration.
• Moltbot console: Open http://127.0.0.1:18789 inside the cloud desktop.

---

AGB Python SDK provides a convenient way to interact with the AGB cloud service.

Features

• Create and manage sessions in the AGB cloud environment
• Access session information
• Work with file system, command execution, and code execution modules
• Browser automation with AI-powered natural language operations
• Advanced browser configuration (stealth mode, proxies, fingerprinting)
• Structured data extraction from web pages

Installation

pip install agbcloud-sdk

Quick Start

from agb import AGB
from agb.session_params import CreateSessionParams

# Initialize AGB with your API key
agb = AGB(api_key="your-api-key")

# Create a session
params = CreateSessionParams(
    image_id="agb-code-space-1",
)
result = agb.create(params)

if result.success:
    session = result.session

    # Execute Python code
    code_result = session.code.run("print('Hello AGB!')", "python")
    print(code_result.result)

    # Execute shell command
    cmd_result = session.command.execute("ls -la")
    print(cmd_result.output)

    # Work with files
    session.file.write("/tmp/test.txt", "Hello World!")
    file_result = session.file.read("/tmp/test.txt")
    print(file_result.content)

    # Clean up
    agb.delete(session)
else:
    print(f"Failed to create session: {result.error_message}")

Documentation

For comprehensive documentation, guides, and examples, visit:

📚 Complete Documentation

• Quick Start Guide - Get started quickly with basic examples
• User Guides - Comprehensive guides and tutorials
• API Reference - Detailed API documentation
• Examples - Practical usage examples

Development

Prerequisites

• Python 3.10 or higher
• pip

Setup

1. Clone the repository:

   git clone https://github.com/agbcloud/agbcloud-sdk.git
   cd agbcloud-sdk
   

2. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -e ."[dev,test]"
   

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.