Skip to content

Wealth Wise is an AI-powered finance advisor with investment insights, financial planning, and real-time market updates using React & Flask. ๐Ÿš€

Notifications You must be signed in to change notification settings

meet244/Wealth-Wise

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ’ฐ Wealth Wise ๐Ÿš€

Wealth Wise is a comprehensive AI-powered personal finance advisor that combines various intelligent features including chatbot capabilities, financial analysis, and more. Built with a modern tech stack, it features a React frontend and a Python Flask backend.

๐Ÿ“ฝ๏ธ Demo

demo.mp4

๐ŸŒŸ Features

โœ… AI-powered reAct agent ๐Ÿค– with LLM integration
๐Ÿ“Š Financial analysis & path planning ๐Ÿ“ˆ
๐Ÿ—ฃ๏ธ Speech processing capabilities ๐ŸŽ™๏ธ
๐Ÿ“ฐ News aggregation & display ๐ŸŒ
๐Ÿ” Secure Google & Metamask login ๐Ÿ”‘
๐Ÿ“Š Clean visual dashboard to summarize all your financial data ๐Ÿ“‰
๐Ÿ“‚ MyData tab to update your financial information โœ๏ธ
๐Ÿ’ก Recommendations tab for the best investment options ๐Ÿ’ฐ
๐Ÿ“š Money Matters โ€“ Learn about finance ๐Ÿฆ
๐Ÿ›ฃ๏ธ Financial Path โ€“ Plan your financial journey visually ๐Ÿ—บ๏ธ
๐Ÿงฎ Money Calculator โ€“ Predict your future finances ๐Ÿ“…
๐Ÿง  AI Agent โ€“ Get real-time financial insights using web & APIs ๐ŸŒ
๐Ÿš€ Money Plus โ€“ Real-time financial news updates ๐Ÿ“ฐ
๐Ÿ“ˆ Stock Analyzer โ€“ Notifies you of the best investment timings ๐Ÿ“Š


๐Ÿ› ๏ธ Tech Stack

๐ŸŽจ Frontend

โš›๏ธ React (TypeScript)
๐ŸŽจ Tailwind CSS for styling
โšก Vite as the build tool
โœ… ESLint for code quality

๐Ÿ–ฅ๏ธ Backend

๐Ÿ Python Flask
๐Ÿง  Google's Gemini AI
๐Ÿค– AI/ML libraries
โ˜๏ธ Cloud services integration


๐Ÿ“‹ Prerequisites

๐Ÿ–ฅ๏ธ Node.js (v16 or higher)
๐Ÿ Python (3.8+)
๐Ÿ“ฆ npm or yarn
๐Ÿ”‘ Required API keys (Gemini, Cloudinary, etc.)


๐Ÿ”ง Installation

๐Ÿ–ฅ๏ธ Backend Setup

1๏ธโƒฃ Navigate to the backend directory:

cd backend

2๏ธโƒฃ Create and activate a virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3๏ธโƒฃ Install Python dependencies:

pip install -r requirements.txt

4๏ธโƒฃ Set up environment variables:

  • Create a .env file in the backend directory
  • Add necessary API keys and configurations

๐ŸŽจ Frontend Setup

1๏ธโƒฃ Navigate to the frontend directory:

cd frontend

2๏ธโƒฃ Install dependencies:

npm install
# or
yarn install

3๏ธโƒฃ Set up environment variables:

  • Create a .env file in the frontend directory
  • Add necessary configuration variables

๐Ÿš€ Running the Application

๐Ÿ–ฅ๏ธ Backend

1๏ธโƒฃ From the backend directory:

python app.py

โœ… The backend server will start on http://localhost:5000

๐ŸŽจ Frontend

1๏ธโƒฃ From the frontend directory:

npm run dev
# or
yarn dev

โœ… The frontend development server will start on http://localhost:5173


๐Ÿ”‘ Environment Variables

โš™๏ธ Backend (.env)

๐Ÿ”น GEMINI_API_KEY
๐Ÿ”น CLOUDINARY_CLOUD_NAME
๐Ÿ”น CLOUDINARY_API_KEY
๐Ÿ”น CLOUDINARY_API_SECRET
๐Ÿ”น Other service-specific API keys

โš™๏ธ Frontend (.env)

๐Ÿ”น VITE_API_URL
๐Ÿ”น Other frontend-specific configurations


๐Ÿ“ Project Structure

WealthWise/
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ app.py              # Main Flask application
โ”‚   โ”œโ”€โ”€ agent.py            # AI agent implementation
โ”‚   โ”œโ”€โ”€ gemini_fin_path.py  # Financial analysis module
โ”‚   โ”œโ”€โ”€ scheduler.py        # Task scheduling
โ”‚   โ””โ”€โ”€ tools/              # Utility functions and tools
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ src/               # React source files
โ”‚   โ”œโ”€โ”€ public/            # Static assets
โ”‚   โ””โ”€โ”€ package.json       # Frontend dependencies

๐Ÿ‘ฅ Authors


๐Ÿ™ Acknowledgments

  • ๐Ÿง  Google Gemini AI
  • ๐Ÿค– OpenAI
  • ๐Ÿ”— Other libraries & services used in the project

About

Wealth Wise is an AI-powered finance advisor with investment insights, financial planning, and real-time market updates using React & Flask. ๐Ÿš€

Topics

Resources

Stars

Watchers

Forks