CoolFace
Apppublic

mvyas55/WealthTracker

sourceHugging Faceupdated 2mo agoView on Hugging Face
0likes
App README

Institutional Wealth Terminal 💼

A high-performance, institutional-grade portfolio visualizer, SIP simulation engine, and wealth optimizer built on a robust, multi-threaded Python backend and raw HTML/JS client.

🚀 Hugging Face Space Deployment Guide

This repository has been configured to build and deploy instantly to Hugging Face Spaces using custom Docker runtime configurations.

📋 Prerequisites

  1. 1.A Hugging Face Account
  2. 2.Git installed locally (or you can upload files directly via the Hugging Face web UI)

🛠️ Step-by-Step Deployment Instructions

Method A: Direct Web Upload (No Git required)
  1. 1.Go to Hugging Face and click on New Space (or visit huggingface.co/new-space).
  2. 2.Configure your Space parameters:
  3. 3.Space Name: wealth-terminal (or any name you prefer)
  4. 4.License: Choose your preference (e.g. mit)
  5. 5.SDK: Select Docker (very important!)
  6. 6.Docker Template: Select Blank
  7. 7.Space Hardware: Free CPU basic is perfectly sufficient!
  8. 8.Visibility: Public or Private
  9. 9.Click Create Space.
  10. 10.Once the Space is created, go to the Files tab, click Add file -> Upload files.
  11. 11.Select and upload the following files from your local workspace:
  12. 12.index.html
  13. 13.app.js
  14. 14.styles.css
  15. 15.nifty500.json
  16. 16.backend.py
  17. 17.requirements.txt
  18. 18.Dockerfile
  19. 19.README.md
  20. 20.Commit your changes. Hugging Face will automatically detect the Dockerfile, build your container, expose port 7860, and run your Wealth Terminal!
Method B: Git Push (Best for developers)
  1. 1.Create a New Space as described in Method A (choosing Docker as your SDK).
  2. 2.Clone your newly created Space repository locally:
bash
   git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
  1. 1.Copy all files from this directory into the cloned folder.
  2. 2.Commit and push the changes:
bash
   git add .
bash
   git commit -m "Deploy Institutional Wealth Terminal"
bash
   git push
  1. 1.Visit your Hugging Face Space URL to watch the build log compile, boot up in under a minute, and run seamlessly!

⚡ Main Technical Features

  • —Dynamic yfinance Downloader: Features highly efficient batch caching and queries only the top 20 active holdings, preventing rate limiting and ensuring latency under 0.2s.
  • —Unified Scraper Cache: Reuses raw HTML page calls inside thread pools to reduce ETMoney network requests by 50%.
  • —Persistent Disk Caching: Writes all scraper details thread-safely to scrape_cache.json on the container filesystem so page refreshes and space rebuilds resolve in 0.01 seconds.