feder-cr/AIHawk

项目概览

它把自然语言任务、真实浏览器交互和可观察的浏览器画面结合起来，并同时提供独立网页界面与 MCP 服务端模式，适合评估需要操作实际网页而非仅调用 API 的自动化场景。

项目类型

AI Agent

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 需要通过真实浏览器操作网页，而不是只调用网站 API 的用户。
• 希望通过本地网页界面观察浏览器操作，或使用兼容 MCP 的助手客户端调用浏览器代理的用户。

核心能力

• 浏览实际网站，并执行指针移动、键盘、点击、输入和页面阅读等操作，以完成用户指定的网页任务。
• 提供本地网页界面，左侧为聊天区域，右侧为实时浏览器视图；用户可输入自然语言任务并观察浏览器操作。
• 提供 MCP 服务端模式，使浏览器代理能够供兼容的助手客户端使用。

限制与风险

• 使用独立网页界面时，用户必须提供 OpenRouter 密钥。
• 必须获取与固定构建匹配的浏览器引擎，或提供匹配的现有二进制文件；不兼容的二进制文件会导致启动被拒绝。
• 如果更改主机配置，暴露出的界面没有认证；部署到其他可访问范围前应将其作为项目特定的接入检查。
• 使用浏览器自动化操作目标网站时，用户必须阅读并遵守相关网站的服务条款和速率限制。
• 如果不遵循项目记录的责任指引，自动化使用可能提交人类尚未阅读的内容；涉及提交操作时应保留人工审核。
• 通过命令行参数传递 OpenRouter 密钥会使其出现在 shell 历史记录中，并且在 Linux 上出现在进程列表中。

如何开始

• 先安装 uv，再使用 uvx invisible-playwright fetch 获取浏览器引擎；随后运行 uvx aihawk ui --openrouter-key sk-...，打开 http://127.0.0.1:8765 并输入任务。独立网页界面需要用户提供 OpenRouter 密钥。

核验依据

• GitHub 项目简介: Open-source AI browser agent for web automation: a web browsing agent and computer-use agent in plain English. Browser MCP for Claude Code and Gemini CLI.
• Release: v0.9.0 the live pane is the window, pointer included
• README: We bring the interface, you bring an [OpenRouter](https://openrouter.ai) key. Chat on the left, the live browser on the right. Windows, in PowerShell: ```powershell powershell -Ex…
• README: Anything that needs real web automation: a browser rather than an API, and a person's judgement about what is on the page. > Go to `<paste the URL>`. One way, Milan to Lisbon, eco…
• README: Windows, in PowerShell: ```powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" $env:Path = "$env:USERPROFILE\.local\bin;$env:Path" uvx in…

来源更新时间：2026-09-06T18:20:26Z

打开原始 GitHub 项目