# HoundBrowser Contributing

Small, reproducible changes with clear behavior and evidence.

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

## Develop locally

Install the development extras and Chromium, then run the Python and JavaScript test suites. Include a controlled fixture when behavior depends on a web page.

```
pip install -e ".[dev]"
python -m playwright install --with-deps chromium
pytest
node --test sdk/js/*.test.mjs
```

## Open a focused pull request

Explain the problem, resulting behavior, and validation. Do not include credentials, customer sites, or scraped private data. Contributions are licensed under Apache 2.0; no separate CLA is required.

## Releases

Versions follow semantic versioning. Initial 0.x releases may change APIs; pin exact versions. A tagged GitHub release includes tested source distributions, a changelog, checksums, and license notices. The hub reads published release data from GitHub.