README.md

metadata

title: HHeuristics Datasets
emoji: 📊
colorFrom: blue
colorTo: green
sdk: docker
pinned: false

HHeuristics Proprietary Datasets App

A FastAPI application that generates, updates, and sells proprietary market research datasets in CSV format. The primary dataset tracks "AI & Tech News Sentiment" using the Finnhub API.

Features

• Data Alchemy Dashboard: A professional showcase demonstrating the "Input → Processing → Output → Profit" pipeline for each data product.
• Real-Time Data: Visualizations powered by the actual CSV data generated by the Premium Data Engine.
• Secure Access: Protected by HTTP Basic Auth.
• Automated Updates: Daily data collection for major AI/Tech companies (NVDA, MSFT, GOOGL, META, AAPL, TSLA, AMD).

Local Development

1. Clone the repository:

   git clone https://github.com/Nhughes09/replit.git
   cd replit
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Set Environment Variables: You need a Finnhub API key.

   export FINNHUB_KEY="your_finnhub_key"
   

4. Run the App:

   uvicorn main:app --reload
   

   Visit http://localhost:8000.

5. Run Data Update Manually:

   python update_data.py
   

Deployment on Hugging Face Spaces

This app is optimized for Hugging Face Spaces (Docker SDK).

1. Create a Space

1. Go to huggingface.co/new-space.
2. Name: hheuristics-datasets (or similar).
3. SDK: Select Docker.
4. Template: Select Blank.
5. Space Hardware: Free (CPU basic) is sufficient.

2. Connect Repository

You can either:

• Sync with GitHub: In the Space settings, connect this GitHub repository.
• Direct Push: Add the Space as a remote and push directly:

  git remote add space https://huggingface.co/spaces/YOUR_USERNAME/SPACE_NAME
  git push space main
  

3. Environment Variables

1. Go to your Space's Settings tab.
2. Scroll to Variables and secrets.
3. Add a Secret:
   • Key: FINNHUB_KEY
   • Value: Your Finnhub API Key.

4. Background Updates

The GitHub Action (.github/workflows/daily_update.yml) will still handle the daily data updates for free! It pushes the new data to GitHub, which will trigger a rebuild of your Space if you have connected them.