# HoundBrowser Installation

Python 3.11 or newer, a supported Chromium build, and an explicit target allowlist.

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

## Install the runtime

Use a virtual environment. The initial release is installed from source; do not assume a package-registry publication.

```
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 --with-deps chromium
```

## Configure access

Generate a service key locally. Keep it out of prompts, browser code, source control, and client-side applications.

```
export HOUNDBROWSER_API_KEYS="$(python -c 'import json,secrets; print(json.dumps({"local":secrets.token_urlsafe(32)}))')"
export HOUNDBROWSER_ALLOWED_ORIGINS='["https://example.com"]'
houndbrowser serve --host 127.0.0.1 --port 8080
```

## Connect to the API

Health is available at /health. Other HTTP routes require Authorization: Bearer followed by the service key. Local loopback HTTP is supported for development; use TLS for remote access.