What is Project Mastermind

Project-Mastermind is an advanced multi-agent system designed to leverage various Large Language Models (LLMs) from the Claude 3 family, enhancing cognitive capabilities through coordinated reasoning.

Use cases

Use cases include automating complex workflows, enhancing decision-making processes, and conducting in-depth analyses across diverse applications.

How to use

To use Project-Mastermind, clone the repository, install the required dependencies, set up your Anthropic API key, and run the provided Python script to process tasks using the orchestrator.

Key features

Key features include the integration of multiple LLMs for different tasks: Claude 3 Haiku for quick processing, Claude 3.5 Sonnet for complex reasoning, and Claude 3 Opus for specialized deep analysis.

Where to use

Project-Mastermind can be utilized in various fields such as artificial intelligence research, natural language processing, and any domain requiring advanced reasoning and task orchestration.

Project MasterMind

An advanced multi-agent system leveraging different LLM models (Claude 3 family) for enhanced cognitive capabilities.

Overview

Project MasterMind combines different Large Language Models (LLMs) into a coordinated system with enhanced reasoning capabilities. It uses:

• Claude 3 Haiku for quick, efficient processing tasks
• Claude 3.5 Sonnet for complex reasoning and orchestration
• Claude 3 Opus for specialized deep analysis

Prerequisites

• Python 3.8 or higher
• An Anthropic API key (Claude access)

Installation

1. Clone the repository:

git clone https://github.com/t4ai-workshops/Project-Mastermind.git
cd Project-Mastermind

2. Install dependencies:

pip install -r requirements.txt

3. Set up your API key:

You’ll need an Anthropic API key to use this project. There are two ways to provide it:

A. Using a .env file (recommended for local development):

# Create a .env file in the project root
echo "ANTHROPIC_API_KEY=your-api-key-here" > .env

B. Setting an environment variable:

# Linux/Mac
export ANTHROPIC_API_KEY=your-api-key-here

# Windows
set ANTHROPIC_API_KEY=your-api-key-here

⚠️ Important: Never commit your API key to version control!

Usage

import asyncio
from mastermind.core import Orchestrator

async def main():
    orchestrator = Orchestrator("your-api-key")
    orchestrator.add_worker()
    
    result = await orchestrator.process_task(
        "Your complex task here"
    )
    print(result.data)

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

Contributing

We welcome contributions! To contribute:

1. Fork the repository
2. Create your feature branch
3. Setup your development environment:
   • Install development dependencies: pip install -r requirements.txt
   • Configure your Anthropic API key as described above
   • Run tests to verify your setup: pytest tests/
4. Commit your changes
5. Push to your branch
6. Create a Pull Request

Note: When running tests locally or in your own fork’s CI/CD pipeline, you’ll need to use your own Anthropic API key. The project’s CI/CD uses a separate key that is only available for the main repository’s workflow.

See CONTRIBUTING.md for detailed guidelines.

License

MIT

Support

For questions or discussions, please open an issue in the repository.