File size: 3,789 Bytes
954b16b
 
 
 
 
7c3354c
 
954b16b
 
 
 
 
 
fd596f4
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
954b16b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
---
title: Multi Agent Research Assistant With Tavily
emoji: 🐨
colorFrom: gray
colorTo: blue
sdk: streamlit
sdk_version: 1.52.0
app_file: app.py
pinned: false
license: mit
short_description: An autonomous Agentic AI system with Tavily web search
---


# πŸ€– Multi-Agent Research Assistant

[![Demo](https://img.shields.io/badge/πŸ€—-Demo%20on%20HF%20Spaces-yellow)](https://huggingface.co/spaces/GhufranAI/Multi_Agent_Research_Assistant_with_Tavily)
[![Python](https://img.shields.io/badge/Python-3.8+-blue)]()

## 🌟 Overview
This project implements a production-ready Agentic AI system featuring four specialized agents that collaborate to conduct research, analyze information, and generate high-quality reports. The system autonomously selects the appropriate tools (web search, calculator, knowledge base) based on query context, demonstrating true agentic behavior.

## ✨ Features
- 🧠 Agentic AI Architecture: Autonomous decision-making with dynamic tool selection
- 🀝 Multi-Agent Collaboration: Four specialized agents working in concert
- πŸ”„ Iterative Refinement: Self-improving through critic feedback loops
- πŸ” Intelligent Search: AI-optimized web search with Tavily + internal knowledge base
- 🎨 Professional UI: Clean, modern Streamlit interface with real-time visualization
- πŸ“Š Source Attribution: Full transparency with citations and confidence scores

## πŸš€ Live Demo
Try it here: [https://huggingface.co/spaces/GhufranAI/Multi_Agent_Research_Assistant_with_Tavily]

## πŸ› οΈ Tech Stack
- **LangGraph** - Agentic workflow orchestration
- **Tavily** - AI-optimized search API
- **Llama 3.1 8B** - Language model
- **Streamlit** - Web interface
- **Pydantic** - Data validation

## πŸ“Š Architecture
- **Agent Responsibilities**

![Agentic workflow simulator](Agentic%20workflow%20simulator.gif)



**πŸ” Researcher Agent**

- **Role**: Information gathering & tool orchestration
- **Tools**: Web search (Tavily), Calculator, Knowledge base
- **Decision Making**: Analyzes query to select optimal tool

  - "latest news" β†’ Web search
  - "calculate 25*4" β†’ Calculator
  - "explain AI" β†’ Knowledge base


- **Output**: Raw information with source attribution

**πŸ“Š Analyst Agent**

- **Role**: Extract insights from research findings
- **Capabilities**: Pattern recognition, theme identification
- **Output**: Key points and implications

**✍️ Writer Agent**

- **Role**: Synthesize research into professional report
- **Format**: Executive summary + findings + implications + sources
- **Output**: Structured, citation-rich report

**🎯 Critic Agent**

- **Role**: Quality assurance & improvement trigger
- **Evaluation**: Scores report on completeness, clarity, sourcing
- **Decision**: Approve (β‰₯8/10) or request revision
- **Output**: Quality score + feedback

## 🎯 Use Cases
- Research current events
- Answer complex questions
- Perform calculations
- Generate comprehensive reports

## πŸ“Έ Screenshots
[<img width="1917" height="997" alt="Screenshot 2025-12-21 210704" src="https://github.com/user-attachments/assets/ad4e8ea1-ed65-4200-a480-907643668c08" />



<img width="1904" height="1029" alt="Screenshot 2025-12-21 213004" src="https://github.com/user-attachments/assets/e6c5f459-791b-4a01-94f0-8de0a8cd7747" />


<img width="1828" height="1029" alt="Screenshot 2025-12-21 213035" src="https://github.com/user-attachments/assets/670bddc6-c635-4cce-893b-40328eb35cf3" />
]

## πŸ’» Local Setup
```bash
pip install -r requirements.txt
streamlit run app.py
```

## πŸ”‘ API Keys
- Hugging Face: https://huggingface.co/settings/tokens (FREE)
- Tavily: https://tavily.com/ (1,000 searches/month free)

## πŸ“ License
MIT

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference