Minions

🚀 MinionWorks - Modular browser agents that work for bananas 🍌

Modular. Scalable. Native AI browser agents for modern web automation.

🚀 Quick Start

Minion Works is a modular AI agent framework that connects to your browser and autonomously executes complex tasks. It's designed for developers, researchers, and curious builders.

✨ Features

• 🌐 Perform Google searches and scrape content.
• 🤖 Use large language models (e.g., GPT - 4) for planned operations.
• 🔗 Modular architecture supporting plug - and - play functional modules.
• 🔎 DOM interaction and content extraction.
• 🔄 Run workflows via Python or UI.

📦 Installation

1. Install the package

   pip install minion-agent
   

2. Set environment variables

   cp .env.example .env
   # Edit your .env file with your OpenAI or other API keys
   

💻 Usage Examples

Basic Usage

Here is a complete example using MinionAgent and langchain - openai:

from langchain_openai import ChatOpenAI
from minion_agent.browser import MinionAgent
import asyncio
from dotenv import load_dotenv

# Load environment variables from the.env file
load_dotenv()

async def main():
    # Example 1: Configure OpenAI using environment variables
    agent1 = MinionAgent(
        task="Compare the prices of GPT-4 and DeepSeek-V3",
        llm=ChatOpenAI(model="gpt-4o"),
        头像隐藏=True
    )
    result1 = await agent1.run()
    print("Result 1:", result1)

    # Example 2: Provide a custom LLM and configuration
    agent2 = MinionAgent(
        task="Find the latest news about AI",
        llm=ChatOpenAI(model="gpt-4o"),
        头像隐藏=False  # Show the browser window
    )
    result2 = await agent2.run()
    print("Result 2:", result2)

if __name__ == "__main__":
    asyncio.run(main())

Advanced Usage

agent = MinionAgent(
    task="Find the top 3 machine learning conferences in 2025 and summarize each.",
    llm=ChatOpenAI(model="gpt-4")
)
await agent.run()

🔧 Technical Details

pytest --maxfail=1 --disable-warnings -q

Make sure you are in the root folder that contains the tests/ folder.

🤝 Contribution

We welcome PRs, feedback, and creative ideas!

1. Fork the repository → Create a branch → Make commits.
2. Add test cases.
3. Submit a Pull Request.
4. Tell your friends 🚀

📄 License

@software{minion_works2025,
  author = {Sairaam, Aman, Cheena},
  title = {Minion Works: Let AI take control of your browser.},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/minionworks/minions}
}