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}
}