Metadata-Version: 2.1
Name: agentmesh-sdk
Version: 0.0.1.dev2
Summary: An open-source multi-agent framework for building agent teams with LLMs
Home-page: https://github.com/MinimalFuture/AgentMesh
Author: Minimal Future
Author-email: zyj@zhayujie.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3
Requires-Dist: requests
Requires-Dist: pyyaml
Requires-Dist: pydantic
Provides-Extra: full
Requires-Dist: browser-use>=0.1.40; extra == "full"

<p align="center"><img src= "https://github.com/user-attachments/assets/743bb0da-3070-4e89-b744-e7b3ab886fe8" alt="AgentMesh" width="450" /></p>

English | <a href="/docs/README-CN.md">中文</a>

AgentMesh is a **Multi-Agent platform** for AI agents building, providing a framework for inter-agent communication,
task planning, and autonomous decision-making. Build your agent team quickly and solve complex tasks through agent
collaboration.

# Quick Start

Choose one of these three ways to build and run your agent team:

## 1. Terminal

Run a multi-agent team from your command line:

### 1.1 Installation

**Requirements:** Linux, MacOS, or Windows with Python installed.

> Python 3.7+ required, 3.11+ recommended (especially for browser tools).
> Download from: [Python.org](https://www.python.org/downloads/).

Clone the repo and navigate to the project:

```
git clone https://github.com/MinimalFuture/AgentMesh
cd AgentMesh
```

Install core dependencies:

```
pip install -r requirements.txt
```

For browser tools, install additional dependencies (optional):

```
pip install browser-use
playwright install
```

### 1.2 Configuration

Edit the `config.yaml` file with your model settings and agent configurations:

```
cp config-template.yaml config.yaml
```

Add your model `api_key` - AgentMesh supports `openai`, `claude`, `deepseek`, `qwen`, and others.

> The template includes a pre-configured `software_team` with three roles (PM, architect, engineer) that collaborate on
> software development tasks.

### 1.3 Execution

```
python main.py -l                   # List available agent teams
python main.py -t software_team     # Run the 'software_team'
```

Enter your requirements in the interactive prompt to begin.

## 2. SDK

Use the AgentMesh SDK to build custom agent teams programmatically:

```
pip install agentmesh-sdk
```

Example usage (replace `YOUR_API_KEY` with your actual API key):

```python
from agentmesh import AgentTeam, Agent, LLMModel
from agentmesh.tools import *

# Initialize model
model = LLMModel(model="gpt-4o", api_key="YOUR_API_KEY")  # Replace with your actual API key

# Create team and add agents
team = AgentTeam(name="software_team", description="A software development team", model=model)

team.add(Agent(name="PM", description="Handles product requirements",
               system_prompt="You are an experienced PM who creates clear, comprehensive PRDs"))

team.add(Agent(name="Developer", description="Implements code based on requirements", model=model,
               system_prompt="You write clean, efficient, maintainable code following requirements precisely",
               tools=[Calculator(), GoogleSearch()]))

# Execute task
result = team.run(task="Write a Snake client game")
```

## 3. Web Service

Coming soon
