Procurement AI

Procurement Intelligence and Vendor Discovery Engine For ERPNext

Installation

You can install this app using the bench CLI:

cd $PATH_TO_YOUR_BENCH
bench get-app $URL_OF_THIS_REPO --branch main
bench install-app procurement_ai

RFQ Playbook

A comprehensive RFQ-to-customer-quotation workflow is available at docs/rfq_pricing_playbook.md.

Phase-wise sample tests with expected results are documented at docs/TEST.md.

Test Documentation Policy

For every future phase-wise implementation update, docs/TEST.md must be updated with user-facing, step-by-step UI test scenarios and expected results for the newly delivered behavior.

Project Plan

Phase-wise implementation roadmap is maintained in PROJECT_PLAN.md.

Phase 1-3 Implementation (In Progress)

Initial backend scaffolding for phase-wise implementation is available in:

• procurement_ai/procurement_ai/services/intake/models.py
• procurement_ai/procurement_ai/services/intake/planner.py
• procurement_ai/procurement_ai/services/intake/engine.py
• procurement_ai/procurement_ai/services/retrieval/context.py
• procurement_ai/procurement_ai/services/discovery/open_web.py
• procurement_ai/procurement_ai/doctype/supplier_discovery_session/supplier_discovery_session.json
• procurement_ai/procurement_ai/doctype/supplier_candidate/supplier_candidate.json
• procurement_ai/procurement_ai/api.py

These modules currently provide request validation, direct-query/file-upload/opportunity item resolution, item normalization, executable ERP -> Open Web -> AI discovery escalation decisions via execute_phase1_payload, and initial Frappe DocType/UI scaffolding for supplier discovery sessions, plus connector-based open-web supplier retrieval.

Source File Header Policy

For every new Python (.py) and JavaScript (.js) file created in this project, prepend the following header comments:

• Copyright (c) 2026, Sanjay Kumar and contributors
• Developed with Open AI Codex
• For license information, please see license.txt

Contributing

This app uses pre-commit for code formatting and linting. Please install pre-commit and enable it for this repository:

cd apps/procurement_ai
pre-commit install

Pre-commit is configured to use the following tools for checking and formatting your code:

• ruff
• eslint
• prettier
• pyupgrade

License

mit