Vendora

Vendora is a powerful Multi-Agent System designed to act as a cohesive "Department" of specialized agents. It integrates with the Model Context Protocol (MCP) to securely access local and remote tools, allowing agents to collaborate and solve complex problems autonomously.

System Architecture

graph TD
    User[User] -->|Interacts via Web UI| UI[React Frontend]
    UI -->|HTTP/WebSocket| API[FastAPI Backend]
    
    subgraph Department [Department / Orchestrator]
        API --> Orch[Orchestrator]
        Orch -->|Delegates Task| AgentA[Search Agent]
        Orch -->|Delegates Task| AgentB[Coder Agent]
        Orch -->|Delegates Task| AgentC[Writer Agent]
    end
    
    subgraph MCP [MCP Integration]
        AgentA -->|Uses Tools| MCPClient[MCP Client]
        AgentB -->|Uses Tools| MCPClient
        MCPClient -->|Connects to| MCPServer1[Local Filesystem]
        MCPClient -->|Connects to| MCPServer2[Web Search]
    end

Loading

Repository Structure

Vendora/
├── multi-agent-system/     # Application: Hierarchical Multi-Agent Department
│   ├── agents/             # Root, Supervisors, and Workers
│   ├── mcp/                # MCP Integrations (Filesystem, etc.)
│   └── main.py             # Application Entry point
├── vendora/                # Framework: Mini-Agents Modules
│   └── README.md           # Framework documentation
├── examples/               # Usage Examples (e.g., MongoDB Agent)
├── tests/                  # System-wide Tests
├── scripts/                # Utility & Maintenance Scripts
├── frontend/               # React (Vite) Frontend
├── .github/                # CI/CD & GitHub Config
├── pyproject.toml          # Project Dependencies & Config
└── README.md               # Project Documentation

Getting Started

Prerequisites

• Python 3.12+
• Node.js 20+

1. Python Setup

Install the project with dependencies:

# Create and activate virtual environment
python -m venv venv
# Windows:
venv\Scripts\activate
# Mac/Linux:
# source venv/bin/activate

# Install Vendora in editable mode
pip install -e .[dev]

The API will be available at http://localhost:8000.

2. Frontend Setup

Navigate to the frontend directory and install dependencies:

cd frontend
npm install

# Start the Development Server
npm run dev

The Web UI will be available at http://localhost:5173.

3. Configuration

Copy .env.example to .env and fill in your API keys:

cp .env.example .env