Metadata-Version: 2.4
Name: agentic-fleet
Version: 0.6.6
Summary: Multi-agent orchestration system built with Microsoft Agent Framework's Magentic Fleet pattern
Project-URL: Homepage, https://github.com/Qredence/agentic-fleet
Project-URL: Documentation, https://github.com/Qredence/agentic-fleet/docs
Project-URL: Repository, https://github.com/Qredence/agentic-fleet
Project-URL: Issues, https://github.com/Qredence/agentic-fleet/issues
Author-email: Qredence <contact@qredence.ai>
License: MIT License
        
        Copyright (c) 2025 Qredence
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: agents,ai,magentic
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <4,>=3.12
Requires-Dist: agent-framework-a2a
Requires-Dist: agent-framework-azure-ai
Requires-Dist: agent-framework-azure-ai-search>=0.0.0a1
Requires-Dist: agent-framework-azurefunctions>=0.0.0a1
Requires-Dist: agent-framework-core
Requires-Dist: agent-framework-declarative>=1.0.0b251120
Requires-Dist: agent-framework-devui
Requires-Dist: agent-framework-mem0
Requires-Dist: agent-framework>=1.0.0b251120
Requires-Dist: aiofiles<26.0,>=25.1.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiomqtt>=1.0.0
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: anyio<5.0,>=4.11.0
Requires-Dist: asyncer<1.0,>=0.0.8
Requires-Dist: azure-ai-agents<2.0,>=1.2.0b5
Requires-Dist: azure-ai-evaluation<2.0,>=1.12.0
Requires-Dist: azure-cosmos<5.0,>=4.8.0
Requires-Dist: azure-identity<2.0,>=1.25.1
Requires-Dist: azure-search-documents>=11.6.0
Requires-Dist: click>=8.1.0
Requires-Dist: databases[asyncpg]<1.0,>=0.7.0
Requires-Dist: dill>=0.3.8
Requires-Dist: dspy>=3.0.3
Requires-Dist: fastapi[standard]<1.0,>=0.120.1
Requires-Dist: gepa[dspy]<1.0,>=0.0.17
Requires-Dist: httpx>=0.24.0
Requires-Dist: ipykernel<8.0,>=7.0.1
Requires-Dist: matplotlib>=3.6.0
Requires-Dist: mcp>=1.21.0
Requires-Dist: mem0ai==1.0.0
Requires-Dist: mlflow>=3.6.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: openai>=2.5.1
Requires-Dist: pandas>=1.5.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: plotly>=5.10.0
Requires-Dist: prometheus-client>=0.16.0
Requires-Dist: prometheus-fastapi-instrumentator>=6.1.0
Requires-Dist: prompt-toolkit<4.0,>=3.0.47
Requires-Dist: psutil>=5.9.0
Requires-Dist: pydantic-settings<3.0,>=2.3.2
Requires-Dist: pydantic<3.0,>=2.12.3
Requires-Dist: python-dotenv<2.0,>=1.2.1
Requires-Dist: python-json-logger>=2.0.7
Requires-Dist: pytz>=2024.1
Requires-Dist: pyyaml<7.0,>=6.0.3
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=14.2.0
Requires-Dist: scipy>=1.9.0
Requires-Dist: seaborn>=0.11.0
Requires-Dist: setuptools>=80.9.0
Requires-Dist: sqlalchemy>=2.0.44
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: statsd>=3.3.0
Requires-Dist: tavily-python>=0.7.12
Requires-Dist: tenacity>=8.2.3
Requires-Dist: textual>=6.5.0
Requires-Dist: tiktoken<1.0,>=0.12.0
Requires-Dist: typer<0.21.0,>=0.20.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: websockets>=10.4
Provides-Extra: all
Requires-Dist: agent-framework-devui; extra == 'all'
Requires-Dist: agent-framework-mem0; extra == 'all'
Requires-Dist: azure-ai-agents<2.0,>=1.2.0b5; extra == 'all'
Requires-Dist: azure-ai-evaluation<2.0,>=1.12.0; extra == 'all'
Requires-Dist: azure-identity<2.0,>=1.25.1; extra == 'all'
Requires-Dist: mem0ai==1.0.0; extra == 'all'
Requires-Dist: prompt-toolkit<4.0,>=3.0.47; extra == 'all'
Requires-Dist: rich>=14.2.0; extra == 'all'
Provides-Extra: azure
Requires-Dist: azure-ai-agents<2.0,>=1.2.0b5; extra == 'azure'
Requires-Dist: azure-identity<2.0,>=1.25.1; extra == 'azure'
Provides-Extra: evaluation
Requires-Dist: azure-ai-evaluation<2.0,>=1.12.0; extra == 'evaluation'
Provides-Extra: memory
Requires-Dist: agent-framework-mem0; extra == 'memory'
Requires-Dist: mem0ai==1.0.0; extra == 'memory'
Provides-Extra: ui
Requires-Dist: agent-framework-devui; extra == 'ui'
Requires-Dist: prompt-toolkit<4.0,>=3.0.47; extra == 'ui'
Requires-Dist: rich>=14.2.0; extra == 'ui'
Description-Content-Type: text/markdown

![AgenticFleet](assets/banner.png)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/agentic-fleet?period=total&units=INTERNATIONAL_SYSTEM&left_color=GREY&right_color=BLUE&left_text=downloads)](https://pepy.tech/projects/agentic-fleet)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/qredence/agentic-fleet)

# AgenticFleet

A self-optimizing multi-agent orchestration system combining **DSPy** for intelligent task routing with **Microsoft agent-framework** for robust execution.

> **Note**: APIs may change between minor versions. Pin a version for production.

## Quick Start

```bash
# Install
git clone https://github.com/Qredence/agentic-fleet.git && cd agentic-fleet
uv sync  # or: pip install agentic-fleet

# Configure
cp .env.example .env
# Edit .env: set OPENAI_API_KEY (required), TAVILY_API_KEY (optional for web search)

# Run
agentic-fleet run -m "Research the latest AI advances" --verbose
```

## What It Does

AgenticFleet routes tasks to specialized AI agents and orchestrates their execution:

```
Task --> Analysis --> Routing --> Agent Execution --> Quality Check --> Output
```

**Agents**: Researcher (web search), Analyst (data/code), Writer, Reviewer, Coder, Planner

**Execution Modes**:
| Mode | Description |
|------|-------------|
| Auto | DSPy picks best mode (default) |
| Delegated | Single agent handles task |
| Sequential | Agents work in pipeline |
| Parallel | Concurrent execution |
| Handoff | Direct agent-to-agent transfers |
| Discussion | Multi-agent group chat |

## Usage

### CLI

```bash
agentic-fleet                                    # Interactive console
agentic-fleet run -m "Your task" --verbose       # Single task
agentic-fleet run -m "Query" --mode handoff      # Specific mode
agentic-fleet list-agents                        # Show available agents
```

### Python API

```python
import asyncio
from agentic_fleet.workflows import create_supervisor_workflow

async def main():
    workflow = await create_supervisor_workflow()
    result = await workflow.run("Summarize transformer architecture")
    print(result["result"])

asyncio.run(main())
```

### Backend API

```bash
./scripts/start_backend.sh  # http://localhost:8000
# Docs: http://localhost:8000/api/docs
```

## Configuration

**Environment** (`.env`):

```bash
OPENAI_API_KEY=sk-...          # Required
TAVILY_API_KEY=tvly-...        # Optional: web search
DSPY_COMPILE=true              # DSPy optimization
```

**Workflow** (`src/agentic_fleet/config/workflow_config.yaml`):

- Models, temperatures, agent settings
- Execution thresholds and limits
- Tracing and evaluation options

## Project Structure

```
src/agentic_fleet/
  agents/        # Agent definitions
  workflows/     # Orchestration logic
  dspy_modules/  # DSPy signatures & reasoner
  tools/         # Tavily, browser, code interpreter
  cli/           # Typer CLI
  app/           # FastAPI backend
src/frontend/    # React UI (optional)
scripts/         # Utilities
docs/            # Documentation
```

## Development

```bash
make install           # Install dependencies
make dev               # Run backend + frontend
make test              # Run tests
make check             # Lint + type-check
```

## Documentation

- [Getting Started](docs/users/getting-started.md)
- [Configuration](docs/users/configuration.md)
- [Architecture](docs/developers/architecture.md)
- [Troubleshooting](docs/users/troubleshooting.md)

## License

MIT - see [LICENSE](LICENSE)

## Acknowledgments

Built with [Microsoft agent-framework](https://github.com/microsoft/agent-framework), [DSPy](https://github.com/stanfordnlp/dspy), and [Tavily](https://tavily.com)
