How vinayakbhat19/aigstverify works
GSTVision AI is a web-based GST invoice verification system. A user uploads an invoice; the backend extracts invoice fields, checks GST and amount compliance, classifies the invoice, assesses fraud risk, stores the result, and can generate a PDF report. The repository also contains a substantial synthetic-invoice generation package, represented as a separate capability. The app excerpt omits parts of the upload handler, so edges for orchestration rely on documented capabilities or are marked unverified; generation links are limited to references visible in sampled source.
Main entry points: app.py FastAPI application · llm_extractor.py Structured extraction · gst_api.py GSTIN lookup · product_classifier.py Product classification
Components 21
Web Application
- FastAPI application
app.py - Upload and results UI
templates - PDF reporting
utils/report_generator.py
Invoice Extraction
- OCR processing
utils/ocr.py - Structured extraction
utils/llm_extractor.py
Verification and Risk
- Invoice validation
utils/validator.py - Amount validation
utils/amount_validator.py - GSTIN lookup
utils/gst_api.py - Product classification
utils/product_classifier.py - GST rate check
utils/gst_rate_validator.py - Duplicate detection
utils/duplicate_detector.py - Fraud assessment
utils/fraud.py - Invoice database
utils/database.py
Synthetic Invoice Data
- Invoice content
datagen/content.py - GST reference data
datagen/gst.py - Invoice styling
datagen/style.py - Invoice rendering
datagen/render.py - Image augmentation
datagen/augment.py
Other components
- Invoice user
- Gemini service
- GST API service
Connections 19
- Invoice user → FastAPI application: uploads invoice
README.md - FastAPI application → Upload and results UI: serves interface
app.py - FastAPI application → OCR processing: extracts text
app.py - FastAPI application → Structured extraction: extracts fields
app.py - FastAPI application → Invoice validation: validates invoice
app.py - FastAPI application → Amount validation: checks amounts
app.py - FastAPI application → GSTIN lookup: checks GSTIN
app.py - FastAPI application → Product classification: classifies invoice
app.py - FastAPI application → GST rate check: checks GST rate
app.py - FastAPI application → Duplicate detection: checks duplicates
app.py - FastAPI application → Fraud assessment: assesses risk
app.py - FastAPI application → Invoice database: saves invoice
app.py - FastAPI application → PDF reporting: generates report
app.py - Structured extraction → Gemini service: requests extraction
- Product classification → Gemini service: requests category
- GSTIN lookup → GST API service: queries GSTIN
- FastAPI application → Invoice database: reads duplicate state
app.py - Invoice content → GST reference data: uses reference data
datagen/content.py - Invoice styling → Invoice content: uses formatters
datagen/style.py