# HoundBrowser documentation

Connect an agent to a scoped browser API. Keep model orchestration in your application and browser execution behind a clear boundary.

Official source: https://ops.warhoundai.com/docs/houndbrowser

## Start with a local service

Install from the repository, configure a service key and approved origin, then create your first browser session. No model provider key or WarHound account is required.

```
git clone https://github.com/warhoundai/HoundBrowser.git
cd HoundBrowser
python -m venv .venv
source .venv/bin/activate
pip install -e .
python -m playwright install chromium
```

## Choose an integration

Use the Python client, the dependency-free JavaScript client, or HTTP directly. Every model uses the same command protocol. The service does not select or bill a model.

## Understand the boundary

Only configured HTTPS origins are reachable. Browser-side JavaScript is available only in unauthenticated sessions. No shell, host filesystem, or CDP endpoint is exposed.