semvec/pypi-packages huggingface dataset:
clado-observe 0.1.1
Clado Observe
License: MIT
Requires Python: >=3.11
Keywords: clado, observe, sdk

# 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).
demo-example-package 0.1.9
A modern Python package with complete CI/CD setup
License: MIT
Requires Python: >=3.11
Keywords: package, python

[![CI/CD](https://github.com/serafinovsky/demo-example-package/actions/workflows/checks.yml/badge.svg)](https://github.com/serafinovsky/demo-example-package/actions/workflows/release-please.yml)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/serafinovsky/demo-example-package)](https://github.com/serafinovsky/demo-example-package/releases)
[![codecov](https://codecov.io/gh/serafinovsky/demo-example-package/branch/master/graph/badge.svg)](https://codecov.io/gh/serafinovsky/demo-example-package)
[![PyPI version](https://badge.fury.io/py/demo-example-package.svg)](https://badge.fury.io/py/demo-example-package)
[![Python Versions](https://img.shields.io/pypi/pyversions/demo-example-package.svg)](https://pypi.org/project/demo-example-package/)
[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
[![Type checked with mypy](https://img.shields.io/badge/mypy-checked-blue.svg)](http://mypy-lang.org/)
[![Security: bandit](https://img.shields.io/badge/security-bandit-green.svg)](https://github.com/PyCQA/bandit)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

# Demo example package

A modern Python package with complete CI/CD setup

> **_NOTE:_** Generated from [cookiecutter-python-package](https://github.com/serafinovsky/cookiecutter-python-package) template for demonstration purposes

## Documentation

- **[Setup Guide](https://github.com/serafinovsky/demo-example-package/blob/master/SETUP.md)** - Initial project configuration
- **[Development Workflow](https://github.com/serafinovsky/demo-example-package/blob/master/WORKFLOW.md)** - How to contribute and work with the project