wehub-resource-sync
99 lines
2.0 KiB
Markdown
99 lines
2.0 KiB
Markdown
# Installation
|
|
|
|
## Agent Integration (Recommended)
|
|
|
|
Tell your AI agent:
|
|
|
|
> Install browser-act. Skill source: https://github.com/browser-act/skills/tree/main/browser-act . Verify it works after installation.
|
|
|
|
The agent will handle CLI installation, Skill configuration, and verify everything is working.
|
|
|
|
## Manual Installation
|
|
|
|
```bash
|
|
uv tool install browser-act-cli --python 3.12
|
|
```
|
|
|
|
Verify:
|
|
|
|
```bash
|
|
browser-act --version
|
|
```
|
|
|
|
## Authentication (Optional)
|
|
|
|
An API Key unlocks the following features:
|
|
|
|
- **stealth browsers** — Anti-detection browsing with fingerprint spoofing
|
|
- **stealth-extract** — One-command extraction of protected page content
|
|
- **Dynamic proxy** — Managed IP rotation, allocated by region
|
|
- **solve-captcha** — Automatic captcha solving
|
|
|
|
Chrome and chrome-direct browsers work without authentication.
|
|
|
|
Get an API Key:
|
|
|
|
```bash
|
|
browser-act auth login
|
|
# Opens registration link → complete signup → poll for the key
|
|
browser-act auth poll
|
|
```
|
|
|
|
Or set it directly:
|
|
|
|
```bash
|
|
browser-act auth set <your-api-key>
|
|
```
|
|
|
|
## Upgrade
|
|
|
|
```bash
|
|
uv tool upgrade browser-act-cli
|
|
```
|
|
|
|
The Skill layer automatically detects mismatches between CLI and Skill content versions and guides the upgrade.
|
|
|
|
## Platform Support
|
|
|
|
| Platform | Status |
|
|
|----------|--------|
|
|
| Windows | Supported |
|
|
| macOS | Supported |
|
|
| Linux | Supported |
|
|
|
|
## Requirements
|
|
|
|
- Python 3.12+
|
|
- Chrome/Chromium (for `chrome` and `chrome-direct` types)
|
|
- API Key (only required for `stealth` type)
|
|
|
|
## Troubleshooting
|
|
|
|
### Command not found after install
|
|
|
|
Make sure the `uv` tool directory is in your PATH:
|
|
|
|
```bash
|
|
uv tool dir
|
|
# Add the output path to your shell PATH
|
|
```
|
|
|
|
### Diagnostics
|
|
|
|
Upload logs for issue diagnosis:
|
|
|
|
```bash
|
|
browser-act report-log
|
|
```
|
|
|
|
Send improvement suggestions:
|
|
|
|
```bash
|
|
browser-act feedback "Description of the issue or suggestion"
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
- [Quick Start](quick-start.md) — Run your first automation
|
|
- [Skills](skills.md) — How agents discover and use BrowserAct
|