IQPS

Intelligent Question Paper Search
Website · Report Bug / Request Feature

Table of Contents

• About The Project
• Development
• Deployment
  • Environment Variables
• Contact
  • Maintainer(s)
  • Creator(s)
• Additional documentation

About The Project

IQPS is a platform for searching and uploading previous year question papers for IIT Kharagpur students. The frontend is deployed at https://qp.metakgp.org and the backend is hosted on a DigitalOcean droplet with 2GB RAM and a single CPU. See MetaPloy for the deployment architecture. IQPS was originally created by Shubham Mishra in python. You can find it here.

Note

Currently in active development. Get involved at our Slack.

Development

1. Clone this repository.
2. Start the backend by running go run . in the backend/ directory.
3. Set up the frontend by running pnpm install and then pnpm start in the frontend/ directory.
4. Profit.

Crawler

[WIP: Steps to locally set up crawler]

Deployment

Backend

0. Set up MetaPloy for production.
1. Clone this repository at a convenient location such as /deployments.
2. cd backend/
3. Set the appropriate production environment variables in the .env file.
4. Run docker compose up to start the backend.
5. Optionally set up a Systemd service to start the wiki on startup or use this deployment github workflow.

Environment Variables

Environment variables can be set using a .env file. Use the .env.template files for reference.

Backend

• DB_PATH: Path to the database file to use.
• STATIC_FILES_URL: The base URL for the static files (PDFs).
• QPS_PATH: The local path on the server to store question paper PDFs.

Frontend

• VITE_BACKEND_URL: The IQPS backend URL. Use http://localhost:5000 in development.

Contact

📫 MetaKGP -

Maintainer(s)

The currently active maintainer(s) of this project.

• Rajiv Harlalka
• Arpit Bhardwaj

Creator(s)

Honoring the original creator(s) and ideator(s) of this project.

• Shubham Mishra

(back to top)

Additional documentation

• License
• Code of Conduct
• Security Policy
• Contribution Guidelines

(back to top)