Multi-Agent Research Assistant (React + FastAPI)

A multi-agent AI research assistant built with React, FastAPI, and Groq LLMs for research paper summarization and related work generation.

---

Prerequisites

• Python 3.10 or later (recommended)
• Node.js 18 or later
• Windows PowerShell (commands below use PowerShell)

---

1. Create and Activate a Virtual Environment

From the project root (multi-agent-research-assistant):

python -m venv .venv
.\.venv\Scripts\Activate.ps1

If PowerShell blocks activation, run this once and try again:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

---

2. Install Python Dependencies

python -m pip install --upgrade pip
pip install -r requirements.txt

---

3. Configure Environment Variables

Create a .env file in the project root.

The application looks for environment variables in:

1. multi-agent-research-assistant/.env
2. The parent directory (for example, Gen-AI Project/.env)

Add your Groq API key:

GROQ_API_KEY=YOUR_GROQ_API_KEY

Default Models

Agent	Purpose	Default Model
B	Summarization	llama-3.3-70b-versatile
C	Related Work	qwen/qwen3-32b

Optional Model Overrides

GROQ_MODEL_SUMMARIZATION=llama-3.3-70b-versatile
GROQ_MODEL_RELATED_WORK=qwen/qwen3-32b

For the latest model IDs, see:

https://console.groq.com/docs/models

---

4. Run the Backend

From the project root:

python main.py

The API will be available at:

http://127.0.0.1:8000

---

5. Run the React Frontend

Open a second terminal.

cd frontend
npm install
npm run dev

Open:

http://localhost:5173

The React development server automatically proxies /api/* requests to the backend running on port 8000.

---

Project Structure

multi-agent-research-assistant/
│
├── frontend/             # React application
├── agents/               # AI agent implementations
├── uploads/              # Uploaded research papers
├── static/               # Static assets
├── templates/            # HTML templates
├── main.py               # FastAPI entry point
├── requirements.txt
├── .env
└── README.md

---

Troubleshooting

Virtual environment won't activate

Run:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Then activate the environment again.

---

Missing Python packages

pip install -r requirements.txt

---

Frontend cannot connect to the backend

• Ensure python main.py is running.
• Verify that port 8000 is not already in use.

---

npm install fails

• Use Node.js 18+
• Delete the frontend/node_modules folder.
• Run:

npm install

again.

---

Tech Stack

• React
• FastAPI
• Groq API
• Python
• JavaScript
• HTML
• CSS