Stonks

Stonks is an AI-powered stock portfolio management platform that provides real-time financial analysis, portfolio tracking, and conversational Q&A about companies using state-of-the-art AI models and live market data.

Features

• Intelligent Dashboard: Track and visualize your stock portfolio with real-time data and interactive charts.
• AI Financial Q&A: Ask detailed financial questions about supported companies and get data-driven answers powered by an open-source BERT model.
• Stock Market Data Integration: Fetches current and historical prices via Yahoo Finance API.
• Portfolio Tracking: Save and analyze your personal portfolio securely with user authentication (Supabase Auth).
• Chat & Analysis History: Session-based conversation management for research traceability.

Screenshots

Dashboard

Login Page

Database Schema

Tech Stack

• Next.js / React: UI / frontend framework
• Supabase: Auth, database, and backend integration
• Yahoo Finance API: Live market data
• BERT QA Model: Financial question answering (using HuggingFace/Transformers, Python FastAPI backend)
• Flask API: Handles ML model inference

Project Structure

• /src/pages: Next.js page routes and React components
• /qa-model-api: Python FastAPI + Huggingface QA server
• /supabase: Database and authentication scripts/config
• /public/assets/images: UI assets and logos
• /sql-db.txt: Database schema (Supabase)

Local Setup

1. Clone the Repository

git clone https://github.com/ykshah1309/Stonks.git
cd Stonks

2. Install Dependencies

npm install

3. Set up Supabase

• Create a project on Supabase
• Use /sql-db.txt to initialize tables
• Add your Supabase URL and anon/public keys to .env.local

4. Run Next.js Frontend

npm run dev

5. Launch Model API

• Navigate to /qa-model-api
• Create a Python environment with required packages (see requirements.txt if present)
• Run FastAPI server (see qa_model_server.py)

Usage

• Access the dashboard at localhost:3000
• Sign up or log in to start your own chat session and portfolio
• Ask financial or company-specific questions in the chat box
• View analytics, historical data, and AI summary

Supported Companies

• Primary support for leading tech stocks (AAPL, MSFT, GOOGL, AMZN, TSLA, META, NVDA, NFLX, IBM, INTC, CSCO, ORCL, ADBE). Others may be added.

Notes

• This project is for educational and research use. Not investment advice.
• Contributions, feedback, and feature pull requests are welcome!

---

Authors: Yash Shah and Vrushali Bharat Chaudhari