Skip to content

Latest commit

ย 

History

118 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ TenderIQ - AI-Assisted Tender Comparison & Analysis Platform

Python Flask MySQL Status License


๐Ÿ“– Overview

TenderIQ is an AI-Assisted Tender Comparison & Analysis Platform designed to automate the process of evaluating multiple tender documents using Natural Language Processing (NLP) and semantic similarity techniques.

The system enables users to upload tender documents in PDF, DOCX, and TXT formats, automatically extracts and preprocesses document content, performs transformer-based semantic clause comparison using Sentence Transformers, identifies similarities and differences, assesses procurement risks, and generates structured comparison reports with executive summaries and actionable recommendations.

Built using Python, Flask, MySQL, Sentence Transformers, Scikit-learn, and HTML, CSS, JS, TenderIQ transforms a traditionally manual and time-consuming tender review process into an intelligent, efficient, and data-driven decision support system for procurement teams.

Project Status: ๐Ÿšง Version 1.0


โญ Key Highlights

  • AI-assisted Tender Comparison
  • Transformer-based Semantic Analysis
  • Clause-Level Matching
  • Procurement Risk Assessment
  • Automated Executive Summary
  • Rule-based Recommendation Engine
  • Interactive Analytics Dashboard
  • Secure Flask Backend
  • MySQL Database Integration
  • Professional Comparison Reports

๐ŸŽฏ Problem Statement

Organizations and procurement teams often receive multiple tender documents that contain hundreds of technical, commercial, and legal clauses.

Traditional tender evaluation is:

  • Time-consuming and resource-intensive
  • Prone to human errors and inconsistent decisions
  • Difficult to scale for large or multiple documents
  • Unable to understand semantic similarities between clauses

TenderIQ addresses these challenges by automating document comparison using NLP-powered semantic analysis, enabling faster, more accurate, and data-driven procurement decisions.


โœจ Features

๐Ÿ” Core Features

  • Secure User Authentication
  • User Registration & Login
  • Password Hashing using Bcrypt
  • Session Management
  • Multi-format Document Upload (PDF, DOCX, TXT)
  • Automatic Document Storage
  • Document Text Extraction
  • Text Cleaning & Preprocessing

๐Ÿค– AI & NLP Engine

  • Transformer-based Sentence Embeddings
  • Semantic Clause Comparison
  • Cosine Similarity Analysis
  • Weighted Similarity Calculation
  • Clause-Level Matching
  • Confidence Score Generation
  • Procurement Risk Assessment
  • Automated Executive Summary
  • Rule-based Recommendation Engine
  • Procurement Insights Generation
  • Interactive Analytics Dashboard

๐Ÿ“Š Reporting

  • Detailed Comparison Reports
  • Clause-Level Analysis
  • Similarity Statistics
  • Procurement Risk Visualization
  • Dashboard Analytics
  • Printable Report Generation

๐Ÿ“ˆ Project Statistics

Statistic Value
Python Modules 20+
Database Tables 3
Supported File Formats 3
NLP Model all-MiniLM-L6-v2
Risk Levels 5
Dashboard Widgets 4
Comparison Type Semantic Clause-Level
Authentication Secure Session-Based
Report Generation Automated

Screenshots

Home Page

Home


Login Page

Login


Registration Page

Register


Dashboard

Dashboard


Comparison Report

Comparison Report


View Tenders

Tender Details


๐Ÿ“Š Performance Metrics

Metric Value
Supported Document Formats PDF, DOCX, TXT
NLP Model Sentence Transformers (all-MiniLM-L6-v2)
Similarity Technique Semantic Cosine Similarity
Comparison Level Clause-Level
Risk Classification Levels 5
Dashboard Analytics 4 Interactive Widgets
Authentication Secure Session-based
Database MySQL
Report Generation Automated

โš™ System Workflow

Authentication โ”‚ โ–ผ Upload Tender Documents โ”‚ โ–ผ Extract Text โ”‚ โ–ผ Text Preprocessing โ”‚ โ–ผ Clause Segmentation โ”‚ โ–ผ Sentence Embedding Generation โ”‚ โ–ผ Semantic Similarity Analysis โ”‚ โ–ผ Clause-Level Matching โ”‚ โ–ผ Weighted Similarity Calculation โ”‚ โ–ผ Procurement Risk Assessment โ”‚ โ–ผ Automated Executive Summary โ”‚ โ–ผ Analytics Dashboard โ”‚ โ–ผ Comparison Report


๐Ÿ— Project Architecture

Frontend (HTML โ€ข CSS โ€ข JavaScript) โ”‚ โ–ผ Flask Routes โ”‚ โ–ผ Business Services โ”‚ โ–ผ Document Processing Engine โ”‚ โ–ผ NLP Engine โ”‚ โ–ผ Sentence Transformer โ”‚ โ–ผ Semantic Comparison Engine โ”‚ โ–ผ Risk Assessment Engine โ”‚ โ–ผ Recommendation Engine โ”‚ โ–ผ Report Generation Engine โ”‚ โ–ผ MySQL Database


๐Ÿ’ป Tech Stack

Backend

  • Python
  • Flask

Database

  • MySQL
  • PyMySQL

AI / NLP

  • Sentence Transformers
  • all-MiniLM-L6-v2
  • Transformers

Machine Learning

  • Scikit-learn
  • Cosine Similarity
  • NumPy
  • PyTorch

Document Processing

  • pdfplumber
  • docx2txt

Frontend

  • HTML5
  • CSS3
  • JavaScript

Authentication

  • Flask Sessions
  • Bcrypt

Developer Tools

  • Git
  • GitHub
  • VS Code

๐Ÿ“ฆ Requirements

Flask
python-dotenv
PyMySQL
bcrypt
pdfplumber
docx2txt
scikit-learn
sentence-transformers
transformers
torch
numpy
requests

Or install directly

pip install -r requirements.txt

๐Ÿš€ Installation

Clone Repository

git clone https://github.com/Astik97/TenderIQ.git

cd TenderIQ

Create Virtual Environment

Windows

python -m venv venv

venv\Scripts\activate

Linux

python3 -m venv venv

source venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Configure Environment Variables

Create

.env

Example

MYSQL_HOST=localhost

MYSQL_USER=root

MYSQL_PASSWORD=your_password

MYSQL_DATABASE=tenderiq

SECRET_KEY=your_secret_key

Import Database

Import

database
      โ”‚
      โ–ผ
tender_system_db_users.sql,
tender_system_db_tenders.sql,
tender_system_db_comparison_reports.sql

into MySQL.


Run Project

python app.py

Open

http://127.0.0.1:5000

โœ… Completed Features

  • User Authentication & Authorization
  • Secure Password Hashing
  • Multi-format Document Upload
  • PDF, DOCX & TXT Processing
  • Automatic Text Extraction
  • Text Cleaning & Preprocessing
  • Clause Segmentation
  • Transformer-based Sentence Embeddings
  • Semantic Similarity Analysis
  • Cosine Similarity Calculation
  • Clause-Level Matching
  • Weighted Similarity Scoring
  • Procurement Risk Assessment
  • Automated Executive Summary
  • Rule-based Recommendation Engine
  • Interactive Analytics Dashboard
  • Comparison Report Generation
  • MySQL Database Integration

๐Ÿ”ฎ Future Roadmap

  • Docker Containerization
  • AWS Cloud Deployment
  • OCR Support for Scanned Documents
  • Multi-language Tender Comparison
  • Role-Based Access Control (RBAC)
  • LLM-powered Clause Explanation
  • Vendor Ranking System
  • Contract Compliance Checking
  • Email Notifications
  • AI Procurement Chat Assistant

๐Ÿ”’ Security

TenderIQ follows secure backend development practices including:

  • Password Hashing using Bcrypt
  • Session-based Authentication
  • Environment Variable Configuration
  • Parameterized SQL Queries
  • Secure MySQL Connectivity
  • Protected User Sessions

๐Ÿงช Testing

The application has been manually tested for:

  • User Authentication
  • Session Management
  • Document Upload
  • PDF/DOCX/TXT Processing
  • Semantic Similarity Validation
  • Clause-Level Comparison
  • Report Generation
  • MySQL Database Operations

๐Ÿค Contribution

Contributions, suggestions, and feedback are always welcome.

Feel free to fork the repository and submit a pull request.


๐Ÿ‘จโ€๐Ÿ’ป Author

Astik Mohapatra

๐ŸŽ“ B.Tech โ€“ Computer Science & Engineering

Government College of Engineering, Keonjhar

Target Roles

  • Python Developer
  • Flask Developer
  • Backend Developer

๐Ÿ“ง astikm7007@gmail.com

๐Ÿ”— LinkedIn

https://linkedin.com/in/astik-mohapatra

๐Ÿ”— GitHub

https://github.com/Astik97


โญ Support

If you found this project useful, please consider giving it a โญ on GitHub.

Your support motivates future development of TenderIQ.


About

AI-Assisted Tender Comparison and Analysis Platform using Python, Flask, MySQL, NLP & LLM integration.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages