OptEx - AI-Powered Personal Finance Management 💰🚀

📌 About OptEx

OptEx is an AI-driven personal finance management web app that helps users track expenses, manage budgets, and plan investments effortlessly. With AI-based receipt scanning, real-time currency conversion, UPI integration, and smart financial insights, OptEx is the ultimate financial companion.

🚀 Problem We Are Solving

Managing personal finances can be time-consuming and complex, especially for:

• Freelancers & professionals struggling to track multiple income sources.
• Students & young professionals needing better savings & investment strategies.
• Small business owners managing expenses manually.
• Individuals filing ITR who require categorized financial reports.

OptEx simplifies this by automating financial tracking, offering AI-driven insights, and providing a seamless tax-ready experience.

✨ Key Features

1. Expense & Income Tracking – Manually or via AI-powered receipt scanning 📄.
2. Multi-Account Support – Track multiple accounts with a default account option 🔄.
3. Real-Time Currency Converter – Convert & manage multiple currencies 🌎💱.
4. Smart Budgeting & Alerts – Get AI-based budget recommendations & alerts 📊.
5. Savings Goal Tracking – Set monthly savings goals & receive alerts on completion 🎯.
6. Investment Insights – AI-driven investment tracking & recommendations 📈.
7. Automated Reports & ITR Assistance – Generate tax-ready financial summaries 📝.
8. UPI Integration & Real-Time Expense Syncing – Auto-track expenses from UPI payments 💳.
9. Security & Bot Protection – Implemented Arcjet bot detection 🛡️.
10. Email Notifications – Automated alerts using EmailJS ✉️.
11. Voice Command – Automated everything with Voice controller🎤.

🏗️ Tech Stack

Frontend & Backend

• Next.js (React Framework) ⚛️
• Typescript & JavaScript 🟨
• Tailwind CSS 🎨 (for modern UI design)
• ShadCN UI 🏗️ (for pre-built UI components)

Database

• Prisma ORM (Supabase) 🗄️ (for efficient data management)

AI & Automation

• Google Gemini API 🤖 (for AI-powered expense categorization & recommendations)
• EmailJS 📩 (for automated email alerts) Earlier It was on SendGrid
• Arcjet 🔒 (for bot detection & security)

🎯 Target Audience

• Freelancers & Gig Workers – Managing multiple revenue streams.
• Young Professionals & Students – Learning financial discipline.
• Small Business Owners – Automating financial tracking.
• Individuals Filing ITR – Generating tax-compliant reports effortlessly.

📈 Business Model

• Freemium Model – Basic features are free, with advanced features in Pro Plan.
• Subscription-Based – AI-powered features, tax assistance, and UPI integration under a paid plan.
• Partnerships – Collaborations with banks & fintech companies for UPI & investment tracking.
• Affiliate Marketing – Recommending financial services (loans, credit cards, etc.)

🛠️ Installation & Setup

1️⃣ Clone the repository:

  git clone https://github.com/your-repo/OptEx.git
  cd OptEx

2️⃣ Install dependencies:

  npm install  # or yarn install

3️⃣ Set up environment variables (EXAMPLE VARIABLES) (.env file):

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY = TOUR_CLERK_KEY
CLERK_SECRET_KEY = TOUR_CLERK_KEY
NEXT_PUBLIC_CLERK_SIGN_IN_URL = example - sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL = example - sign-up
DATABASE_URL=YOUR_DATABASE_POOL_URL
DIRECT_URL=YOUR_KEY
ARCJET_KEY=YOUR_KEY    
GEMINI_API_KEY = YOUR_KEY
NEXT_PUBLIC_EXCHANGE_RATE_API_KEY=YOUR_KEY
NEXT_PUBLIC_EMAILJS_SERVICE_ID=YOUR_SERVICE_ID
NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=YOUR_TEMPLATE_ID
NEXT_PUBLIC_EMAILJS_PUBLIC_KEY=YOUR_PUBLIC_KEY
NEXT_PUBLIC_PUBLISHABLE_KEY=YOUR_KEY
STRIPE_SECRET_KEY=YOUR_KEY

4️⃣ Run the development server:

  npm run dev  # or yarn dev

---

🤝How to make Contribution

We welcome contributions from developers of all skill levels! Whether you're fixing a bug, adding new features, or improving documentation, your help is appreciated.

To contribute:

1. ⭐ Star the repository to show your support.
2. 📝 Create an issue outlining how you'd like to contribute to the project.
3. 🍴 Fork the repository to make your own copy:

   # Click on the "Fork" button at the top right of the repository page

4. 💻 Implement your changes in the forked repository by creating a new branch for your feature or fix:

   git checkout -b feature-or-fix-name
   

5. Make your changes and commit them using Conventional Commits:

   git commit -m "feat: describe your changes"
   

6. 🔄 Push your branch:

   git push origin feature-or-fix-name
   

7. Open a pull request and describe the changes you made, mentioning the issue number you're addressing.
8. ⏳ Wait for review and feedback from the maintainers.

---

📜 License

This project is licensed under the MIT License.

✨ Connect With Us

📧 Email: amansingh080704@gmail.com