🤖 Multi-Agent AI Assistant

A powerful AI chat application built with FastAPI and multi-agent architecture, designed to provide specialized AI assistance through different expert agents.

The system uses LLM-based workflows to route user requests to the most suitable AI agent, enabling better responses for general queries, coding, research, and creative tasks.

---

✨ Features

🤖 Specialized AI Agents

Agent	Purpose
🧠 General Assistant	General questions, explanations, and problem solving
💻 Code Assistant	Programming help, debugging, and optimization
⚙️ Technical Expert	Software engineering and technical guidance
✍️ Creative Writer	Stories, content creation, and brainstorming
🔎 Research Assistant	Information analysis and summaries

---

🌍 Multi-Language Support

Supports multiple languages including:

• 🇺🇸 English
• 🇧🇩 Bengali
• 🇮🇳 Hindi
• 🇪🇸 Spanish
• 🇫🇷 French
• 🇩🇪 German
• 🇵🇹 Portuguese
• 🇨🇳 Chinese
• 🇯🇵 Japanese
• 🇰🇷 Korean
• 🇸🇦 Arabic

---

🏗️ Architecture

User
 │
 ▼
Web Interface
 │
 ▼
FastAPI Backend
 │
 ▼
Agent Router
 │
 ├── General Agent
 ├── Code Agent
 ├── Research Agent
 ├── Technical Agent
 └── Creative Agent
 │
 ▼
LLM Provider

---

🛠️ Tech Stack

Backend

• Python
• FastAPI
• WebSocket
• REST API

Frontend

• HTML
• CSS
• JavaScript

AI Integration

• OpenRouter API
• LLM-based agent routing
• Multi-agent workflow design

Infrastructure

• Docker support
• Linux deployment ready

---

📂 Project Structure

multi-agent-ai/
│
├── main.py
├── README.md
├── requirements.txt
├── .env.example
│
├── static/
│   ├── css/
│   ├── js/
│   └── images/
│
└── tests/

---

🚀 Installation

1. Clone Repository

git clone https://github.com/faridahmed-devhub/multi-agent-ai.git

cd multi-agent-ai

---

2. Create Virtual Environment

python -m venv venv

Activate:

Windows:

venv\Scripts\activate

Linux/Mac:

source venv/bin/activate

---

3. Install Dependencies

pip install -r requirements.txt

---

⚙️ Configuration

Create a .env file:

OPENROUTER_API_KEY=your_api_key_here

Never commit your API keys to GitHub.

---

▶️ Run Application

python main.py

Open:

http://localhost:8000

---

🔌 API Example

Chat Request

{
  "message": "Explain Python decorators",
  "language": "en",
  "agent": "code"
}

Response

{
  "response": "Python decorators are...",
  "agent": "code",
  "language": "en"
}

---

🎯 Use Cases

• AI customer support assistants
• Coding assistants
• Research automation
• Personal productivity tools
• AI workflow experiments
• Enterprise AI assistants

---

🔮 Future Improvements

• Memory system for conversations
• More specialized agents
• RAG document search
• Voice interaction
• User authentication
• Agent collaboration workflows

---

🤝 Contribution

Contributions are welcome!

Steps:

1. Fork the repository
2. Create a feature branch
3. Commit changes
4. Open a Pull Request

---

👨‍💻 Author

Farid Ahmed

Software Engineer | Backend • Full Stack • AI Engineering

GitHub: https://github.com/faridahmed-devhub

LinkedIn: https://linkedin.com/in/faridahmed-devhub

---

📄 License

This project is open-source and available under the MIT License.