Skip to content

An autonomous AI-powered financial assistant for India’s 77M gig workers — helping users automate budgeting, track spending, forecast income, and build long-term financial stability.

Notifications You must be signed in to change notification settings

omkar-103/flexflow-ai

Repository files navigation

FlexFlow AI

FlexFlow AI Next.js React TypeScript Tailwind CSS Live Demo


Transforming Gig Workers' Financial Instability into Predictable, Credit-Ready Stability

⚡ A fully autonomous AI-powered financial management platform built for India’s 77M gig workers. ⚡

💎 FlexFlow AI – Homepage Preview 💎

Homepage

🚀 Live Demo · 📖 Docs · 🛠️ Install


🏆 Built for MumbaiHacks 2025

Team Invisible No More

👤 Omkar Parelkar · 👤 Bhavesh Kadam · 👤 Atharva Vidhate · 👤 Harsh Salkar


Explore the FlexFlow AI interface, designed for simplicity and powerful financial tracking.

📊 Command Center

Real-time financial tracking and predictive analytics at a glance.

2. Main Dashboard 3. Deep Analytics
Dashboard Analytics
Central hub for income, savings, and credit score. Detailed breakdown of spending habits and forecasting.

🤖 AI Intelligence

Our autonomous agents work 24/7 to secure your financial future.

4. AI Agents Hub 7. AI Chatbot
AI Agents Chatbot
Configure Income, Defense, Credit, and Growth agents. Ask financial questions and get instant, data-driven advice.

⚙️ Management & Utilities

Complete control over your account settings and historical data.

5. Transaction History 6. User Settings
History Settings
* comprehensive log of all earnings and expenses.* Personalize your profile and app preferences.


📑 Table of Contents


Problem Statement

India's 77M gig workers—delivery partners, ride-hail drivers, and freelancers—face:

  • ❌ No consistent income
  • ❌ No financial tools built for variable earnings
  • ❌ No access to credit due to missing formal income proof
  • ❌ Increased risk of debt traps and predatory loans

Despite contributing ₹1.25T yearly to the digital economy, they remain financially invisible.


Our Solution

FlexFlow AI autonomously stabilizes finances using 4 AI agents. Unpredictable Income → Stability → Savings → Credit Access → Growth

Agent Function
💰 Income Agent Predicts earnings + sends peak hour alerts
🛡 Defense Agent Controls spending + detects financial risks
💳 Credit Agent Builds alternative credit identity based on gig data
🚀 Growth Agent Helps upgrade skills and optimize platforms

Features

Feature Description Status
AI Dashboard Real-time financial insights ✅ Live
Income Forecasting 7-30 day earning predictions ✅ Live
Credit Builder Alternative credit scoring model ✅ Live
Smart Vault Auto-savings system 🚧 Soon
Multi-platform Sync Zomato, Swiggy, Uber, Ola integration 🚧 Soon

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Library: React 19
  • Language: TypeScript
  • Styling: TailwindCSS
  • Visualization & Motion: Recharts + Framer Motion
  • Deployment: Vercel

Getting Started

📌 Requirements

  • Node.js >= 18
  • npm >= 9
  • Git

Installation

# Clone the repository
git clone [https://github.com/YOUR-USERNAME/flexflow-ai.git](https://github.com/YOUR-USERNAME/flexflow-ai.git)

# Navigate to the project directory
cd flexflow-ai

# Install dependencies
npm install

▶️ Run Locally

npm run dev
# Open http://localhost:3000 in your browser

▶️ Production Build

npm run build && npm start

API Documentation (Mock Mode)

FlexFlow AI currently uses mock APIs for smooth frontend development and testing. These endpoints simulate real financial data until backend integration is complete.

🔹 Example Endpoint: Income Prediction

Request:

GET /api/income

Sample Response:

{
  "forecast": [1200, 1500, 900, 2000],
  "totalPredicted": 18000,
  "peakHours": ["6-9 PM", "12-2 PM"]
}

Project Folder Structure

flexflow-ai/
│
├── .next/                    # Build output generated by Next.js
│
├── app/                      # Main Next.js App directory (App Router)
│   ├── agents/               # UI screens and components related to AI agents
│   ├── analytics/            # Analytics dashboard page
│   ├── api/                  # Backend API routes (Next.js server functions)
│   │   ├── agent/            # Individual agent logic routes
│   │   ├── agents/           # Aggregated agent data routes
│   │   └── analytics/        # Analytics data endpoints
│   ├── auth/                 # Authentication screens (Login, Signup)
│   ├── chat/                 # AI chat interface routes
│   ├── credit/               # Credit score and financial sections
│   ├── dashboard/            # Main user dashboard
│   ├── expenses/             # Expense tracking pages
│   ├── history/              # User history and logs
│   ├── income/               # Income analysis pages
│   ├── login/                # Standalone login route
│   ├── profile/              # User profile section
│   ├── settings/             # Application/user settings UI
│   ├── vault/                # Secure financial vault UI
│   └── layout.tsx            # Global application layout
│
├── components/               # Reusable UI components
│   ├── charts/               # Data visualization and graph components
│   ├── settings/             # User preference UI components
│   └── ui/                   # Shared UI library (AuthModal, Navbar, Sidebar, etc.)
│
├── contexts/                 # Global React Context providers (Auth, Theme, App)
├── data/                     # Static datasets and mock AI chat data
├── hooks/                    # Reusable custom React hooks
├── lib/                      # Backend services, DB config, and utilities
├── public/                   # Public static assets
├── styles/                   # Global stylesheet utilities
├── .env.local                # Environment variables
├── next.config.ts            # Next.js configuration
├── package.json
└── README.md

Design Philosophy

  • Glassmorphism: Modern dark UI with translucent, glass-like elements.
  • Accessibility: WCAG-compliant contrast and navigation.
  • Mobile-First: optimized for gig workers accessing the app on the go.

Deployment

We recommend deploying to Vercel for the best compatibility with Next.js.

vercel --prod

Team

Name Role
Omkar Parelkar Team Lead + Full Stack Dev
Bhavesh Kadam AI Systems & Logic
Atharva Vidhate UX Design + Frontend Dev
Harsh Salkar Research & System Architecture

Fun Note

MumbaiHacks was amazing — except for the WiFi. Our AI agent was learning the concept of "patience" while waiting for the internet to connect. 😂

About

An autonomous AI-powered financial assistant for India’s 77M gig workers — helping users automate budgeting, track spending, forecast income, and build long-term financial stability.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published