<div align="center">

🤖 Multi-Agent AI System

An agentic AI orchestrator where autonomous agents collaborate to research, write, and review — powered by CrewAI & LangChain

Features • Architecture • Quick Start • Agents • Tools

</div>

---

📌 Overview

This project demonstrates Agentic AI — a paradigm where multiple AI agents autonomously collaborate to complete complex tasks. Instead of a single LLM call, the system decomposes tasks into subtasks, assigns them to specialized agents, and orchestrates their collaboration.

Use Case: AI Research & Content Pipeline

Given a topic, the system:

1. 🔍 Research Agent — searches the web, gathers sources, extracts key insights
2. ✍️ Writer Agent — synthesizes research into a well-structured article
3. 📝 Editor Agent — reviews, fact-checks, and refines the final output
4. 📊 Analyst Agent — generates data-driven insights and visualizations

---

✨ Features

• 🤖 4 Specialized AI Agents — each with unique roles, goals, and backstories
• 🔧 Custom Tool Integration — web search, content scraping, code execution
• 🧠 Agent Memory — short-term, long-term, and entity memory
• 📋 Task Delegation — hierarchical and sequential task orchestration
• 🔄 Human-in-the-Loop — optional human approval at critical decision points
• 📊 Structured Output — Pydantic-validated outputs from each agent
• 🌊 Streaming — Real-time agent thought process streaming
• 📝 Comprehensive Logging — full trace of agent reasoning and actions

---

🏗 Architecture

┌──────────────────────────────────────────────────────────┐
│                    Crew Orchestrator                      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐   │
│  │   Research    │  │    Writer    │  │    Editor    │   │
│  │    Agent      │→│    Agent     │→│    Agent     │   │
│  │              │  │              │  │              │   │
│  │ • Web Search │  │ • Synthesis  │  │ • Review     │   │
│  │ • Scraping   │  │ • Structuring│  │ • Fact-check │   │
│  │ • Analysis   │  │ • Formatting │  │ • Refinement │   │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘   │
│         │                 │                 │            │
│         ▼                 ▼                 ▼            │
│  ┌────────────────────────────────────────────────────┐  │
│  │              Shared Memory & Context               │  │
│  └────────────────────────────────────────────────────┘  │
│         │                 │                 │            │
│         ▼                 ▼                 ▼            │
│  ┌────────────────────────────────────────────────────┐  │
│  │                  Custom Tools                      │  │
│  │  🔍 Search  │  🌐 Scraper  │  📊 Analyzer        │  │
│  └────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────┘

---

🚀 Quick Start

Installation

git clone https://github.com/altafpinjari2001/multi-agent-ai-system.git
cd multi-agent-ai-system

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

pip install -r requirements.txt
cp .env.example .env
# Add your API keys to .env

Run

# Run the research pipeline
python main.py --topic "Latest advances in Agentic AI 2025"

# Interactive mode
python main.py --interactive

# With specific output format
python main.py --topic "RAG vs Fine-tuning" --output markdown

---

🤖 Agents

1. Research Agent 🔍

role = "Senior Research Analyst"
goal = "Find comprehensive, accurate information on any given topic"
tools = [WebSearchTool, WebScraperTool, WikipediaTool]

2. Writer Agent ✍️

role = "Technical Content Writer"
goal = "Transform research into engaging, well-structured content"
tools = [FileWriterTool]

3. Editor Agent 📝

role = "Senior Content Editor"
goal = "Ensure content accuracy, clarity, and professional quality"
tools = [FileReaderTool]

4. Analyst Agent 📊

role = "Data Analyst"
goal = "Extract quantitative insights and create data visualizations"
tools = [CodeExecutorTool, ChartGeneratorTool]

---

🔧 Custom Tools

| Tool | Description | |------|-------------| | WebSearchTool | Searches the web using Serper API with result parsing | | WebScraperTool | Extracts clean content from URLs using BeautifulSoup | | WikipediaTool | Fetches Wikipedia summaries for fact-checking | | FileWriterTool | Writes structured content to files | | CodeExecutorTool | Safely executes Python code for data analysis | | ChartGeneratorTool | Generates charts and visualizations |

---

📁 Project Structure

multi-agent-ai-system/
├── main.py                    # Entry point
├── requirements.txt
├── .env.example
├── src/
│   ├── __init__.py
│   ├── config.py              # Configuration
│   ├── crew.py                # Crew orchestration
│   ├── agents/
│   │   ├── __init__.py
│   │   ├── research_agent.py
│   │   ├── writer_agent.py
│   │   ├── editor_agent.py
│   │   └── analyst_agent.py
│   ├── tasks/
│   │   ├── __init__.py
│   │   ├── research_task.py
│   │   ├── writing_task.py
│   │   ├── editing_task.py
│   │   └── analysis_task.py
│   ├── tools/
│   │   ├── __init__.py
│   │   ├── search_tool.py
│   │   ├── scraper_tool.py
│   │   └── code_executor.py
│   └── models/
│       ├── __init__.py
│       └── output_models.py
├── tests/
│   ├── test_agents.py
│   ├── test_tools.py
│   └── test_crew.py
├── output/                    # Generated content
├── .github/workflows/ci.yml
├── LICENSE
└── .gitignore

---

📄 License

MIT License — see LICENSE for details.

---

<div align="center"> <b>⭐ Star this repo if you find it useful!</b> </div>