Metadata-Version: 2.4
Name: side-builder
Version: 0.1.8
Summary: AI-powered Selenium IDE (.side) player and builder for Selenium and Playwright
Project-URL: Homepage, https://github.com/tayaee/side-builder
Project-URL: Repository, https://github.com/tayaee/side-builder.git
Project-URL: Issues, https://github.com/tayaee/side-builder/issues
Author-email: Soonki Ji <soonki.ji@gmail.com>
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Requires-Dist: click>=8.3.1
Requires-Dist: openai>=2.24.0
Requires-Dist: playwright>=1.58.0
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: selenium>=4.41.0
Description-Content-Type: text/markdown

# Side Builder and Player

Build and execute Selenium IDE (.side) scripts with AI-powered efficiency.

## Key Features
* **AI-Powered Recording:** Generate `.side` files using natural language. No more manual F12 inspection.
* **Cost-Efficient:** Use AI only for recording; execution is 100% local and free.
* **Standard Format:** Fully compatible with the Selenium IDE (.side) ecosystem.
* **Developer Friendly:** Supports both Sync/Async Playwright and Selenium APIs.
* **Zero-Config Selectors:** AI automatically finds the best ID, CSS, or XPath for you.

## Quick Start

### Installation (via uv)
```bash
git clone https://github.com/tayaee/side-builder.git
cd side-builder
uv tool install -e .
side-builder --help
```

### Running Examples
```
cd examples/saucedemo/login-cart-order-logout
uv run login_cart_order_logout_sync.py
```

## Why Side Builder?
Stop fighting with broken CSS selectors. side-builder bridges the gap between AI-driven intent and browser automation, allowing you to focus on the workflow rather than the HTML structure.

## Prerequisites
* Python 3.10+
* OpenAI API Key (Required only for the recording phase)

## License
This project is licensed under the MIT License.
