Metadata-Version: 2.4
Name: vibium
Version: 0.1.4
Summary: Browser automation for AI agents and humans
Project-URL: Homepage, https://vibium.com
Project-URL: Repository, https://github.com/VibiumDev/vibium
Project-URL: Issues, https://github.com/VibiumDev/vibium/issues
Author-email: Jason Huggins <hugs@vibium.com>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Requires-Python: >=3.9
Requires-Dist: vibium-darwin-arm64>=0.1.4; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: vibium-darwin-x64>=0.1.4; sys_platform == 'darwin' and platform_machine == 'x86_64'
Requires-Dist: vibium-linux-arm64>=0.1.4; sys_platform == 'linux' and platform_machine == 'aarch64'
Requires-Dist: vibium-linux-x64>=0.1.4; sys_platform == 'linux' and platform_machine == 'x86_64'
Requires-Dist: vibium-win32-x64>=0.1.4; sys_platform == 'win32' and platform_machine == 'AMD64'
Requires-Dist: websockets>=14.2
Description-Content-Type: text/markdown

# Vibium Python Client

Browser automation for AI agents and humans.

## Installation

```bash
pip install vibium
```

Chrome downloads automatically on first use. To install Chrome ahead of time:

```bash
vibium install
```

## Quick Start

```python
from vibium import browser_sync

vibe = browser_sync.launch()
vibe.go("https://example.com")

# Take a screenshot
png = vibe.screenshot()
with open("screenshot.png", "wb") as f:
    f.write(png)

# Find and click a link
link = vibe.find("a")
print(link.text())
link.click()

vibe.quit()
```

## Async API

```python
import asyncio
from vibium import browser

async def main():
    vibe = await browser.launch()
    await vibe.go("https://example.com")

    link = await vibe.find("a")
    await link.click()

    await vibe.quit()

asyncio.run(main())
```

## CLI

```bash
vibium install   # Download Chrome for Testing
vibium version   # Show version
```

## Requirements

- Python 3.9+

## License

Apache-2.0
