Metadata-Version: 2.4
Name: vibium
Version: 26.3.18
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>=26.3.18; sys_platform == 'darwin' and platform_machine == 'arm64'
Requires-Dist: vibium-darwin-x64>=26.3.18; sys_platform == 'darwin' and platform_machine == 'x86_64'
Requires-Dist: vibium-linux-arm64>=26.3.18; sys_platform == 'linux' and platform_machine == 'aarch64'
Requires-Dist: vibium-linux-x64>=26.3.18; sys_platform == 'linux' and platform_machine == 'x86_64'
Requires-Dist: vibium-win32-x64>=26.3.18; sys_platform == 'win32' and platform_machine == 'AMD64'
Requires-Dist: websockets>=14.2
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
Requires-Dist: pytest>=7.0; extra == 'test'
Description-Content-Type: text/markdown

# Vibium

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

bro = browser.start()
vibe = bro.page()
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()

bro.stop()
```

## Async API

```python
import asyncio
from vibium.async_api import browser

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

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

    await bro.stop()

asyncio.run(main())
```

## CLI

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

## Requirements

- Python 3.9+

## Links

- [GitHub / Documentation](https://github.com/VibiumDev/vibium)
- [Website](https://vibium.com)

## License

Apache-2.0
