🚀 浏览器代理机器人 – MinionWorks 🍌香蕉代工人
MinionWorks 是一款模块化的原生 AI 浏览器代理，专为现代网络自动化设计，具有可扩展性，能帮助开发者、研究人员等自主执行复杂的浏览器任务。
🚀 快速开始
Minion Works 是一个模块化的 AI 代理框架，它能够连接到您的浏览器并自主执行复杂任务，是为开发者、研究人员和好奇的构建者量身打造的工具。
✨ 主要特性
- 🌐 可执行 Google 搜索并抓取相关内容。
- 🤖 能借助大语言模型（如 GPT - 4）进行计划操作。
- 🔗 采用模块化架构，支持即插即用的功能模块，方便灵活扩展。
- 🔎 支持 DOM 交互与内容提取。
- 🔄 既可以通过 Python 运行工作流，也能通过 UI 进行操作。
📦 安装指南
安装包
pip install minion-agent
设置环境变量
cp .env.example .env
# 使用 OpenAI 或其他 API 密钥编辑您的 .env 文件
💻 使用示例
基础用法
使用 MinionAgent 和 langchain - openai 的完整示例：
from langchain_openai import ChatOpenAI
from minion_agent.browser import MinionAgent
import asyncio
from dotenv import load_dotenv
# 加载来自 .env 文件的环境变量
load_dotenv()
async def main():
# 示例 1：使用环境变量配置 OpenAI
agent1 = MinionAgent(
task="比较 GPT-4 和 DeepSeek-V3 的价格",
llm=ChatOpenAI(model="gpt-4o"),
头像隐藏=True
)
result1 = await agent1.run()
print("结果 1:", result1)
# 示例 2：提供自定义 LLM 和配置
agent2 = MinionAgent(
task="查找关于 AI 的最新新闻",
llm=ChatOpenAI(model="gpt-4o"),
头像隐藏=False # 显示浏览器窗口
)
result2 = await agent2.run()
print("结果 2:", result2)
if __name__ == "__main__":
asyncio.run(main())
高级用法
agent = MinionAgent(
task="找到 2025 年的前 3 个机器学习会议并摘要每项。",
llm=ChatOpenAI(model="gpt-4")
)
await agent.run()
🧪 测试
pytest --maxfail=1 --disable-warnings -q
⚠️ 重要提示
请确保您在包含 tests/ 文件夹的根文件夹中进行测试操作。
🤝 贡献
我们热烈欢迎大家提交 PR、反馈和创意想法！贡献步骤如下：
- 叉库 → 分支 → 提交
- 添加测试用例
- 提交 Pull Request
- 告诉你的朋友 🚀
📖 引用
@software{minion_works2025,
author = {Sairaam, Aman, Cheena},
title = {Minion Works: 让 AI 掌管您的浏览器。},
year = {2025},
publisher = {GitHub},
url = {https://github.com/minionworks/minions}
}