🚀 AI Stock Price Predictor

An AI-powered financial market predictor supporting multiple global markets and asset classes.

---

✨ Key Features

• 🌍 Multi-Market Support: Predicts across global markets including India (NSE/BSE), US (NYSE/NASDAQ), China, Europe, and Japan.
• 📈 Diverse Asset Classes: Supports Stocks, Crypto, Forex, and Mutual Funds.
• 🧠 Advanced AI Predictions: Uses powerful ML models like Linear Regression, LSTM, and more for future price trends.
• 📊 Interactive Dashboard: Experience real-time charts, indicators, and deep analytics.
• 💳 Trading Simulator: A comprehensive paper trading environment connected to real-time market data.
• 🤖 AI Chatbot: A personalized trading assistant that provides insights and answers financial questions.
• 🔒 Secure Environment: Real-time mock authentication and administrative controls.

---

💼 Enterprise Features

✓ JWT Authentication
✓ MongoDB Persistence
✓ AI Financial Assistant
✓ Portfolio Tracking
✓ Market Analytics
✓ Automated Report Generation
✓ Admin Dashboard
✓ KYC Workflow
✓ Multi-Market Support

---

🏗️ Project Architecture

📊 1. Data Pipeline & ML Engine (Click to expand)

• Live Data Fetching: Utilizes yfinance to grab up-to-date market information across multiple asset classes globally.
• Machine Learning Models:
  • Linear Regression: Used as a fast baseline model for short-term trend predictions.
  • LSTM Models: Used for long-term pattern recognition and trend analysis.
• Pre-Processing: Handles missing values, scaling, and feature engineering to feed the optimal data into our models.

🖥️ 2. Core Backend Services (Click to expand)

• API Layer: Built entirely in Fastapi to ensure high performance and fully documented asynchronous endpoints.
• Database Integration: Leverages MongoDB AsyncIO Motor driver to manage user profiles, chat histories, portfolios, and transaction data scalably.
• Stateful Services: Connects with LLMs (e.g., Google GenAI) for intelligent trading chats and market insight generations.

📱 3. User Interface (Click to expand)

• Framework: Next.js 14 utilizing the App router for high SEO and rendering performance.
• Styling: A fully responsive UI featuring dark/light modes powered by TailwindCSS and Custom components for a premium look.
• State Management: Real-time connection with backend APIs using robust hooks and scalable context providers.

---

🎯 Use Cases

• Retail Investors: Use AI predictions to validate their trading ideas and paper trade risk-free.
• Day Traders: Utilize the real-time advanced dashboard and multi-market insights.
• Financial Enthusiasts: Query the AI chatbot to understand market conditions without spending hours reading reports.

---

🛠️ Tech Stack

Backend

• Framework: FastAPI (Python)
• Machine Learning: TensorFlow, Scikit-learn, Pandas
• Data Source: yfinance

Frontend

• Framework: Next.js (React)
• Styling: Tailwind CSS / CSS Modules

---

🚀 Getting Started

Follow these steps to set up the project locally.

⚙️ 1. Backend Setup (Click to expand)

1. Navigate to the backend directory:

   cd backend/

2. Create a virtual environment:

   python -m venv venv

3. Activate the virtual environment:

   venv\Scripts\activate  # On Windows
   # source venv/bin/activate  # On macOS/Linux

4. Install dependencies:

   python -m pip install -r requirements.txt

5. Run the backend server:

   python -m uvicorn app.main:app --reload

💻 2. Frontend Setup (Click to expand)

1. Navigate to the frontend directory:

   cd frontend/

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

---

🔑 Accessing the Admin Dashboard

To access the Admin Dashboard, you don't need a separate admin login portal. Because the application currently uses mock authentication, you simply need to create a regular account using the designated "master" admin email address!

Admin Login Steps (Click to collapse)

1. Log Out of your current account (if you are logged in) by clicking your profile icon in the top right.
2. Go to the Sign Up page.
3. Create a brand new account using this exact email address: admin@trademind.com (You can use any name and password you like, as long as the email matches exactly).
4. Complete the signup and verification.
5. Once logged in, click your Profile icon in the top right corner of the navigation bar.
6. You will now see a special purple "Admin Dashboard" link in the dropdown menu.
7. Clicking that link will take you directly to /admin, where you can view all registered users and use the "Grant Access" / "Revoke Access" / "Approve Payment" buttons to control their subscriptions!

_{Built with ❤️ for Traders & Investors}