---
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**:
   ```bash
   git clone https://github.com/Nhughes09/replit.git
   cd replit
   ```

2. **Install dependencies**:
   ```bash
   pip install -r requirements.txt
   ```

3. **Set Environment Variables**:
   You need a Finnhub API key.
   ```bash
   export FINNHUB_KEY="your_finnhub_key"
   ```

4. **Run the App**:
   ```bash
   uvicorn main:app --reload
   ```
   Visit `http://localhost:8000`.

5. **Run Data Update Manually**:
   ```bash
   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](https://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:
    ```bash
    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.