Metadata-Version: 2.4
Name: headless-engine
Version: 1.0.1
Summary: Ultra-lightweight (<30MB RAM), detection-free headless browser engine for AI agents, web scraping, and MCP servers.
Author-email: Headless Engine Contributors <maintainers@headless-engine.dev>
License: MIT OR Apache-2.0
Project-URL: Homepage, https://github.com/yutuknown/headless-engine
Project-URL: Repository, https://github.com/yutuknown/headless-engine
Project-URL: Issues, https://github.com/yutuknown/headless-engine/issues
Project-URL: Changelog, https://github.com/yutuknown/headless-engine/releases
Keywords: headless-browser,web-scraping,ai-agents,mcp,stealth
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# headless-engine

Ultra-lightweight (<30MB RAM), detection-free pure-Rust headless browser engine for AI agents, web scraping, and MCP servers.

## Installation

```bash
pip install headless-engine
```

The first run automatically downloads the precompiled `headless-engine` binary for your platform from GitHub Releases. No manual setup required.

## Usage

```python
from headless_engine import HeadlessBrowser

with HeadlessBrowser() as browser:
    report = browser.navigate("https://en.wikipedia.org/wiki/Artificial_intelligence")
    markdown = browser.extract_markdown()
    print(markdown)
```

## Environment Variables

| Variable | Description |
| :--- | :--- |
| `HEADLESS_ENGINE_BIN` | Override the path to the `headless-engine` binary |

## Links

- [GitHub](https://github.com/yutuknown/headless-engine)
- [Releases](https://github.com/yutuknown/headless-engine/releases)
