Skip to content

joelRamireZzz/researchBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ResearchBot

AI-powered scientific paper search engine

FastAPI React Groq Python


Search scientific papers across Semantic Scholar and arXiv simultaneously,
and get AI-generated summaries in seconds — completely free.


ResearchBot Demo


Features

  • Parallel search across Semantic Scholar and arXiv
  • Automatic summaries generated by LLaMA 3.3 via Groq
  • Full paper details — authors, year, citation count, and direct link
  • Fast and free — no paid API required
  • Elegant dark UI with serif typography

Tech Stack

Layer Technology
Frontend React 18 + Vite + TailwindCSS
Backend FastAPI + Python 3.11
AI Groq API (LLaMA 3.3 70B)
Data sources Semantic Scholar API + arXiv API
HTTP client httpx (async)

Getting Started

Prerequisites

  • Python 3.11+
  • Node.js 18+
  • A free account at console.groq.com to get your API key

1. Clone the repository

git clone https://github.com/joelRamireZzz/research-bot.git
cd research-bot

2. Set up the backend

cd backend
python -m venv venv

# Windows
venv\Scripts\activate

# Mac/Linux
source venv/bin/activate

pip install fastapi uvicorn httpx groq python-dotenv

Create a .env file inside the backend folder:

GROQ_API_KEY=gsk_your_api_key_here

Start the server:

uvicorn main:app --reload

Backend will be available at http://127.0.0.1:8000

3. Set up the frontend

Open a new terminal:

cd frontend
npm install
npm run dev

Frontend will be available at http://localhost:5173


Usage

  1. Open http://localhost:5173 in your browser
  2. Type a research topic in the search bar
  3. Click Search
  4. Browse the results with AI-generated summaries

Example queries

machine learning drug discovery
quantum computing algorithms
climate change renewable energy
neural networks image recognition

Project structure

research-bot/
├── backend/
│   ├── main.py          # FastAPI app + endpoints
│   ├── .env             # API keys (not committed)
│   └── requirements.txt
└── frontend/
    ├── src/
    │   ├── App.jsx      # Main component
    │   └── App.css      # Styles
    └── package.json

Getting a free Groq API key

  1. Go to console.groq.com
  2. Sign in with your Google account
  3. Click API Keys in the sidebar
  4. Create a new key and paste it into your .env file

Made with by @joelRamireZzz

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors