Metadata-Version: 2.4
Name: clado-observe
Version: 0.1.1
Summary: Clado Observe
Project-URL: Homepage, https://github.com/clado-ai/observability
Project-URL: Issues, https://github.com/clado-ai/observability/issues
Author-email: Clado <david@clado.ai>
License: MIT
License-File: LICENSE.md
Keywords: clado,observe,sdk
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: anthropic>=0.38.0
Requires-Dist: browser-use>=0.1.37
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: websockets>=12.0
Description-Content-Type: text/markdown

# Clado Observe

A Python SDK for browser agent observability using Chrome DevTools Protocol (CDP).

## Features

- Browser agent observability through Chrome DevTools Protocol
- Integration with Browser Use
- WebSocket-based communication with Chrome instances
- DOM, Network, Screenshot and screencast capabilities
- Vision-Language Model (VLM) evaluation support

## Installation

```bash
pip install clado-observe
```

## Quick Start

```python
import os

from browser_use.llm import ChatAnthropic
from dotenv import load_dotenv

from clado_observe.agents.browser_use import Agent

load_dotenv()


def main() -> None:
    agent = Agent(
        task="Find the number of stars of the browser-use repo",
        llm=ChatAnthropic(model="claude-sonnet-4-0"),
        cdp_url=cdp_url,
        api_key=os.getenv("CLADO_API_KEY", ""),
    )

    agent.run_sync()

if __name__ == "__main__":
    main()
```

## Local Development

### Testing with Chrome DevTools

To test locally, you need a Chrome DevTools WebSocket debugger URL.

#### 1) Start Chrome with remote debugging enabled

```bash
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug
```

Keep this Chrome instance running while you test.

#### 2) Verify and copy the WebSocket URL

Open `http://localhost:9222/json/version` in your browser. Find the `webSocketDebuggerUrl` field and copy its value. It will look like:

```
ws://localhost:9222/devtools/browser/<some-guid>
```

#### 3) Set your `.env`

Create or update `.env` with your keys and the copied URL:
OPENAI_API_KEY is necessary for the VLM evaluation and another API key is needed in accordance to the browser use environment variable configuration.

```bash
ANTHROPIC_API_KEY=sk-... 
WEBSOCKET_DEBUGGER_URL=ws://localhost:9222/devtools/browser/<some-guid>
CLADO_API_KEY=cl-...
OPENAI_API_KEY=sk-proj-...
```

## Documentation

For more detailed documentation, please visit [https://github.com/clado-ai/observability](https://github.com/clado-ai/observability)

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Support

For issues and feature requests, please use the [GitHub issue tracker](https://github.com/clado-ai/observability/issues).