amitlals
Add quick start guide for end-users
97e7e46
# πŸš€ SAP Finance Dashboard - Quick Setup Guide
## βœ… Status: Live & Ready!
Your SAP Finance Dashboard is **fully deployed** on Hugging Face Spaces at:
### πŸ”— https://huggingface.co/spaces/amitgpt/sap-finance-dashboard-RPT-1-OSS
---
## πŸ” One Final Step: Enable Model Features (5 minutes)
The dashboard is **fully functional** but needs your HF authentication to use AI prediction features.
### Quick Setup (3 clicks):
#### Step 1️⃣: Accept Model Access
- Go to: https://huggingface.co/SAP/sap-rpt-1-oss
- Click the blue **"Agree"** button
- βœ“ Done
#### Step 2️⃣: Create Access Token
- Visit: https://huggingface.co/settings/tokens
- Click **"New token"**
- Name: `sap-rpt-oss-access`
- Type: **"Read"**
- Click **"Create token"**
- πŸ“‹ Copy the token (long string starting with `hf_`)
#### Step 3️⃣: Add to Your Space
- Go to your Space: https://huggingface.co/spaces/amitgpt/sap-finance-dashboard-RPT-1-OSS
- Click **βš™ Settings** (top right)
- Find **"Repository secrets"**
- Click **"Add secret"**
- Name: `HF_TOKEN`
- Value: Paste your token
- Click **"Add secret"**
- Wait 1-2 minutes for rebuild
#### ✨ Done!
When the rebuild finishes, refresh the Space and all features work!
---
## πŸ“š What Each Tab Does
| Tab | Function | Status |
|-----|----------|--------|
| **Dashboard** | Financial metrics & charts | βœ… Works |
| **Data Explorer** | Browse datasets | βœ… Works |
| **Upload** | Upload custom data | βœ… Works |
| **OData** | Connect to SAP systems | βœ… Works |
| **Predictions** | AI-powered forecasts | ⏳ Needs HF token |
| **Playground** | Train & test models | ⏳ Needs HF token |
---
## πŸ› οΈ How the Auth Works
1. You set `HF_TOKEN` in HF Spaces secrets
2. Space rebuilds with token available
3. Your app automatically logs in to Hugging Face
4. Model downloads from gated repository
5. Model cached for fast access
**Your token is ONLY used to download the model. No data is uploaded.**
---
## ❓ Troubleshooting
| Problem | Solution |
|---------|----------|
| Still see 401 error | Wait 2+ min for rebuild, refresh browser |
| "HF_TOKEN not found" | Check secret name is exactly `HF_TOKEN` (case-sensitive) |
| Model still won't load | Verify you clicked "Agree" on model page |
| Old app still showing | Hard refresh: Ctrl+Shift+R (or Cmd+Shift+R on Mac) |
---
## πŸ“– Full Documentation
For detailed setup, troubleshooting, and security info:
- See: `HF_AUTHENTICATION_SETUP.md` in the repo
---
## πŸŽ‰ That's It!
Your SAP Finance Dashboard is ready. With one authentication token, you'll unlock full AI functionality.
**Questions?** Check the troubleshooting section or read `HF_AUTHENTICATION_SETUP.md` for detailed guidance.
---
*Powered by Gradio β€’ HuggingFace Spaces β€’ SAP-RPT-1-OSS*