GeM BidPlus Automation handles the entire bid participation workflow on bidplus.gem.gov.in so you don't have to click through it manually.

• 🔐 Smart Login — Captcha OCR via Tesseract with manual fallback, OTP auto-fetch from email (IMAP)
• 🔍 Bid Search — Exact bid search and one-click participation
• 📋 Catalogue Offering — Automatic catalogue selection, encrypt & save
• 💰 Offer Price — Price entry, estimated price modal handling, encrypt & save
• 📄 Document Upload — Bulk upload mapped by document field keys with flexible file resolution
• 🏦 EMD/EPBG — Navigate and save
• ✅ Bid Verification — Consent checkbox, OTP verification (auto-fetch or manual)
• 🧠 Smart Flow Detection — Reads the sidebar progress indicator to resume from the current step
• 🛡️ Anti-Detection — Patchright (Playwright fork) with human-like delays, typing, scrolling, and mouse movement

# Ubuntu / Debian sudo apt install tesseract-ocr # macOS brew install tesseract # Windows — https://github.com/UB-Mannheim/tesseract/wiki

git clone https://github.com/FlacSy/gem-automation.git cd gem-automation python -m venv .venv source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate # Windows pip install -r requirements.txt patchright install chromium

cp .env.example .env # Edit .env with your GeM login, password, and (optionally) email for OTP

python main.py

The script will:

1. Open Chrome and navigate to GeM BidPlus
2. Log in (captcha → password → OTP)
3. Search for the specified bid and click Participate
4. Run through all bid participation steps automatically
5. Wait for you to press Enter before closing the browser

GEM_DEBUG=1 python main.py

Enables verbose logging and saves artifacts (HAR, traces, screenshots) to debug_logs/artifacts/.

* Prompted interactively in the console if not set.

All CSS selectors, timeouts, delays, and flow-specific settings live in config.yaml. You rarely need to modify this file unless the GeM portal changes its markup.

The upload flow maps document fields (defined in config.yaml → upload_documents.document_fields) to files on disk. Resolution order:

1. Environment variable — GEM_UPLOAD_DOC_<KEY> (e.g. GEM_UPLOAD_DOC_EXPERIENCE_CRITERIA=/path/to/file.pdf)
2. Directory scan — matching filename from GEM_UPLOAD_DOCUMENTS_DIR (see document_filename_by_key in config)
3. Fallback — GEM_UPLOAD_DOCUMENT_FILE

gem-automation/ ├── main.py # Entry point ├── config.yaml # Selectors, timeouts, delays ├── logger.py # Logging (file + console in DEBUG) ├── browser/ │ ├── stealth_browser.py # Patchright Chrome launch │ └── humanization.py # Human-like interactions ├── flows/ │ ├── base.py # BaseFlow ABC │ ├── flow_detector.py # Bid participation state detection │ ├── login.py # Login flow │ ├── search.py # Search & participate │ ├── catalogue.py # Catalogue offering │ ├── offer_price.py # Offer price │ ├── upload_documents.py # Document upload │ ├── emd_epbg.py # EMD/EPBG │ └── verify_bid.py # Verify bid with OTP └── utils/ ├── config.py # YAML + Pydantic config loader └── email_client.py # IMAP OTP fetcher 

Login → Search → [ Flow Detector ] → Catalogue → Offer Price → Upload Docs → EMD/EPBG → Verify Bid ↑ | └──────────────── re-detect after each step ───────────────────┘ 

The Flow Detector reads the sidebar (ul.progress-indicator) to determine which step is current and which are already completed, so the automation always resumes from the right place.

This tool is provided for educational and research purposes. Use it responsibly and in compliance with GeM's terms of service. The authors are not responsible for any misuse or consequences arising from the use of this software.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

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

Please open an Issue for bugs or feature requests.

This project is licensed under the MIT License — see LICENSE for details.