Skip to content

Developed during Hack-a-Sol 2025 hackathon hosted by IIIT Naya Raipur

License

Notifications You must be signed in to change notification settings

CoderUzumaki/Lumen

Repository files navigation

πŸ”† LUMEN - AI-Powered Invoice Management System

LUMEN Logo

Transforming Invoice Management with Artificial Intelligence

Built for Hack-a-Sol IIIT Naya Raipur Team

πŸ“Ί Demo Video β€’ πŸ“‹ Problem Statement β€’ πŸš€ Quick Start β€’ πŸ“– Documentation


πŸ“‹ Table of Contents


🎯 About

LUMEN is an intelligent invoice management system built for Hack-a-Sol Hackathon at IIIT Naya Raipur by Team dUnder Pressure. The project addresses the critical challenge of manual invoice processing in modern businesses by leveraging cutting-edge AI technologies.

Built For

  • Event: Hack-a-Sol Hackathon
  • Institution: Indian Institute of Information Technology, Naya Raipur
  • Team: dUnder Pressure
  • Challenge: View Problem Statement

πŸ” Problem Statement

See PROBLEM_STATEMENT.md for the complete problem statement.

Manual invoice processing is a time-consuming, error-prone task that costs businesses significant resources. Finance teams spend 8+ hours weekly on:

  • Manual data entry from invoices
  • Cross-verification and validation
  • Payment tracking and reminders
  • Spending analysis and reporting
  • Fraud detection and compliance

The Challenge: Build an AI-powered solution that automates invoice processing, provides intelligent analytics, and enables natural language querying of financial data.


πŸ’‘ Our Solution

LUMEN transforms invoice management through three core pillars:

1. πŸ€– Intelligent OCR & Data Extraction

  • 95%+ accuracy in invoice data extraction
  • Support for images, PDFs, and multi-page documents
  • Automatic validation and error detection
  • Real-time processing with instant feedback

2. πŸ“Š AI-Powered Analytics

  • Pattern Detection: Identifies spending trends and seasonal patterns
  • Anomaly Detection: Flags suspicious transactions and potential fraud
  • Forecasting: Predicts future spending with ML models
  • Risk Assessment: Evaluates vendor and payment risks
  • Smart Insights: AI-generated recommendations for cost savings

3. πŸ’¬ Natural Language Query Interface

  • Ask questions in plain English
  • Hybrid SQL + RAG system for comprehensive answers
  • Context-aware responses with data citations
  • Query classification for optimal routing

✨ Key Features

πŸ” Smart Invoice Processing

  • Drag & Drop Upload: Simple file upload interface
  • Batch Processing: Handle multiple invoices simultaneously
  • Auto-validation: Intelligent field validation
  • Database Storage: Secure PostgreSQL storage
  • Export Options: Excel, CSV, PDF reports

πŸ“ˆ Advanced Analytics Dashboard

  • Real-time KPIs: Annual spending, monthly averages, overdue payments
  • Spending Trends: Interactive graphs with forecasts
  • Category Breakdown: Pie charts and detailed analysis
  • Payment Calendar: Visual payment schedule
  • Alert System: Automated reminders and notifications

πŸ€– AI Assistant (Chatbot)

  • Conversational Interface: Natural language queries
  • Multi-agent System: SQL Agent + RAG System + Analytics Orchestrator
  • Query Examples:
    • "Show me all invoices from last month"
    • "Which vendor has the highest spending?"
    • "Are there any unusual transactions?"
    • "What's my projected spending for next quarter?"

🎨 Modern User Interface

  • Dark Mode: Elegant dark theme throughout
  • Responsive Design: Works on desktop, tablet, and mobile
  • Animations: Smooth Framer Motion animations
  • Accessibility: WCAG compliant components
  • Intuitive Navigation: Easy-to-use sidebar and breadcrumbs

πŸ› οΈ Tech Stack

Frontend

  • Framework: Next.js 14.2.5 (React 18)
  • Language: TypeScript
  • Styling: Tailwind CSS
  • UI Components: Radix UI + Shadcn/ui
  • Animations: Framer Motion
  • Charts: Recharts
  • Icons: Lucide React, Tabler Icons
  • HTTP Client: Axios

Backend

  • Framework: Flask 3.0.0
  • Language: Python 3.11+
  • Database: SQLite (dev) / PostgreSQL (production)
  • ORM: SQLAlchemy with Alembic migrations
  • AI/ML:
    • OpenRouter API (LLM integration)
    • Google Cloud Vision API (OCR)
    • Sentence Transformers (embeddings)
    • ChromaDB (vector database)
    • Scikit-learn (ML models)

AI Agents

  • Query Classifier: Routes queries to appropriate systems
  • SQL Agent: Generates and executes SQL queries
  • RAG System: Retrieval-Augmented Generation for document Q&A
  • Pattern Detection Agent: Identifies spending patterns
  • Anomaly Detection Agent: Fraud and anomaly detection
  • Forecasting Agent: Time-series forecasting
  • Risk Assessment Engine: Vendor and payment risk analysis

DevOps

  • Version Control: Git & GitHub
  • API Testing: Postman
  • Environment: Virtual environments (venv)
  • CORS: Flask-CORS for cross-origin requests

πŸš€ Getting Started

Prerequisites

  • Node.js 18+ and npm
  • Python 3.11+
  • Git

Quick Start

# Clone the repository
git clone https://github.com/CoderUzumaki/Lumen.git
cd Lumen

πŸ“š Complete Documentation:


πŸŽ₯ Demo

Video Demonstration

πŸ“Ί Watch Full Demo on YouTube

Note: Replace YOUR_VIDEO_ID with your actual YouTube video ID after uploading the demo.

Demo Highlights:

  • πŸ“„ Invoice upload and OCR extraction
  • πŸ“Š AI analytics dashboard walkthrough
  • πŸ’¬ Natural language query examples
  • 🚨 Anomaly detection in action
  • πŸ“ˆ Forecasting and insights
  • 🎯 End-to-end workflow demonstration

Live Screenshots

Click to view screenshots

Landing Page

Landing Page

Dashboard

Dashboard

AI Analytics

AI Analytics

Chat Interface

Chat Interface


πŸ‘₯ Team

Team dUnder Pressure

Built with dedication by our amazing team for Hack-a-Sol @ IIIT Naya Raipur:

Member Role Responsibilities GitHub
[Your Name] Full Stack Lead Frontend architecture, UI/UX, Landing page @CoderUzumaki
[Team Member 2] AI/ML Engineer AI agents, ML models, Analytics @username2
[Team Member 3] Backend Developer API development, Database, OCR integration @username3
[Team Member 4] Designer & Frontend Component design, Animations, Testing @username4

Note: Replace team member names and GitHub usernames with your actual team information.


πŸ† Acknowledgments

Special Thanks

  • Hack-a-Sol Organizing Committee at IIIT Naya Raipur
  • Mentors and Judges for their guidance and feedback
  • Open Source Community for the amazing tools and libraries

Technologies & Services


πŸ“„ License

This project was created for the Hack-a-Sol Hackathon at IIIT Naya Raipur.


πŸ“ž Contact

For questions or feedback about this project:


Built with ❀️ by Team dUnder Pressure for Hack-a-Sol @ IIIT Naya Raipur

⭐ Star us on GitHub if you find this project helpful!

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •