Skip to content

agarwalnitesh42/theMatrixAI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⟐ THE MATRIX — Financial Deprogramming System

"The Matrix has you... Want out?"

An AI-powered financial deprogramming platform that scans your money psychology, exposes the invisible systems controlling your finances, and gives you a personalized escape plan — delivered through iconic Matrix characters.

Every other finance app tells you WHAT to do with money. This one tells you WHY you don't do it — then fixes that first.


🔴 What This Is

This isn't another budgeting app with a cool skin. It's a mental deprogramming system disguised as a Matrix experience.

Most people are stuck financially — not because they're stupid, but because they're running on code that was installed by their environment. The kid who grew up watching parents stress about rent thinks differently about money than the one who watched parents negotiate deals. Neither chose it. Both live with the consequences.

The Matrix breaks that cycle in 3 phases:

  1. Psychological Scan — Before any financial advice, we understand YOUR money psychology. What your parents taught you. How you react to salary. Who you're trying to impress.

  2. Financial Matrix Score — See exactly how trapped you are. EMI burden, toxic debt, savings rate, emergency fund — all calculated from YOUR real numbers. Not generic percentages.

  3. Personalized Escape Plan — AI-powered advice that's different for someone making ₹5LPA vs ₹50LPA. Different for someone with credit card debt vs someone with a home loan. Real numbers. Real strategy.


🎭 7 Characters, 7 Perspectives

Character Role What They Do
⟐ NEO The One Breaks your financial illusions with brutal truth and real numbers
⊛ MORPHEUS The Guide Asks devastating questions that crack your money beliefs
◎ ORACLE The Prophet Reflects your own financial truth back at you
◆ TRINITY The Executor Turns your goals into 90-day military-precision action plans
◇ ARCHITECT The Analyst Cold mathematical analysis of your financial systems
▣ AGENT SMITH The Villain Says out loud what your inner critic whispers — so you can destroy it
◐ CYPHER The Traitor Honestly shows you the real cost of financial freedom

✨ Features

  • 🧠 Psychological profiling — 3 deep questions about your money psychology before any numbers
  • 📊 14-point financial scan — income, rent, EMIs, debts, investments, all asked separately and precisely
  • 🎯 Matrix Score (0-100) — calculated from savings rate, EMI burden, toxic debt, emergency fund, investing habit
  • 📈 Visual dashboards — radar chart, expense pie chart, 25-year wealth projection
  • 💬 AI-powered chat — typewriter effect, character-accurate responses, uses YOUR exact numbers
  • 🔑 Pluggable API — works with Claude (Anthropic), ChatGPT (OpenAI), or Gemini (Google)
  • 📱 Bank statement upload — drag-and-drop PDF/CSV parsing (demo in v1, real parsing in v2)
  • 🎮 Awakening progression — level up from ASLEEP → THE ONE as you engage
  • 📞 Phone ringing exit — cinematic exit sequence
  • 🔗 Share your score — Twitter/X share card with your Matrix Score
  • 🌧️ Digital rain — cinematic falling code background throughout
  • 📺 CRT overlay — scanlines + vignette for authentic terminal feel
  • 🎬 Boot sequence — full system initialization with ASCII art
  • 💊 Red/Blue pill — interactive choice with typewriter Morpheus quote
  • 🥚 Easter egg — "there is no spoon" hidden in the UI

🚀 Quick Start

# Clone the repo
git clone https://github.com/YOUR_USERNAME/the-matrix-ai.git
cd the-matrix-ai

# Install dependencies
npm install

# Start dev server
npm run dev

Open http://localhost:3000 — take the red pill.


🔑 API Configuration

The app supports 3 AI providers. You'll be prompted to enter your key on first launch:

Provider Get Key Model Used
Anthropic console.anthropic.com Claude Sonnet 4
OpenAI platform.openai.com GPT-4o
Google aistudio.google.com Gemini 2.0 Flash

Your API key stays in your browser. It's never sent to any server except the AI provider you choose.

There's also a Demo Mode if you just want to explore the UI.


🏗️ Deploy

Vercel (Recommended)

Deploy with Vercel

Netlify

Deploy to Netlify

Manual

npm run build
# Deploy the `dist` folder to any static host

📁 Project Structure

the-matrix-ai/
├── index.html          # Entry point with OG meta tags
├── package.json
├── vite.config.js
├── src/
│   ├── main.jsx        # React entry
│   ├── App.jsx         # Main app — all screens and components
│   ├── styles/
│   │   └── global.css  # All styles (also inlined in App for artifact mode)
│   └── utils/
│       ├── characters.js   # Character definitions and system prompts
│       ├── ai.js           # AI provider abstraction (Claude/GPT/Gemini)
│       └── finance.js      # Financial calculation engine
└── public/
    └── og-image.png    # Social share image (add your own)

🤝 Contributing

This is open source. If you want to make it better:

  1. Fork it
  2. Create a branch (git checkout -b feature/bank-parser)
  3. Commit your changes
  4. Push and open a PR

Most wanted contributions:

  • Real bank statement PDF parser (Indian banks)
  • More nuanced financial advice logic
  • Additional language support
  • Mobile UI improvements
  • Sound effects / audio

📜 License

MIT — do whatever you want with it. If it helps someone break free from their financial matrix, that's all that matters.


"I'm trying to free your mind, Neo. But I can only show you the door. You're the one that has to walk through it."

⟐ THE MATRIX — Financial Deprogramming System

About

theMatrixAI

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors