Minions

🚀 浏览器代理机器人 – 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、反馈和创意想法！贡献步骤如下：

1. 叉库 → 分支 → 提交
2. 添加测试用例
3. 提交 Pull Request
4. 告诉你的朋友 🚀

📖 引用

@software{minion_works2025,
  author = {Sairaam, Aman, Cheena},
  title = {Minion Works: 让 AI 掌管您的浏览器。},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/minionworks/minions}
}