| | --- |
| | title: AI Financial Assistant (Single Container) |
| | emoji: ⚙️ |
| | colorFrom: red |
| | colorTo: green |
| | sdk: docker |
| | app_port: 8501 |
| | pinned: false |
| | --- |
| | |
| | # AI Financial Assistant - Morning Market Brief (Single Container) |
| |
|
| | This application provides a voice-interactive morning market brief. It uses several AI agents for: |
| | - Speech-to-Text (STT) |
| | - Natural Language Understanding (NLU - simulated) |
| | - Financial Data API Fetching |
| | - Web Scraping for Earnings |
| | - Document Retrieval (FAISS) |
| | - Data Analysis |
| | - Language Generation (LLM) |
| | - Text-to-Speech (TTS) |
| |
|
| | All services run within a single Docker container managed by Supervisord. |
| |
|
| | ## How to Use |
| | 1. The application will start automatically once the Space is built. |
| | 2. Access the public URL provided by Hugging Face Spaces. |
| | 3. Use the Streamlit interface to record your query or upload an audio file. |
| | 4. Click "Generate Market Brief". |
| |
|
| | ## Environment Variables (Secrets) |
| | The following secrets **must be set in your Hugging Face Space settings** for the application to function correctly: |
| |
|
| | - `FMP_API_KEY` |
| | - `ALPHAVANTAGE_API_KEY` |
| | - `GOOGLE_API_KEY` |
| | - `GEMINI_MODEL_NAME` (Optional): Defaults to `gemini-1.5-flash-latest` if not set. |
| | - `WHISPER_MODEL_SIZE` (Optional): Defaults to `small` if not set. |
| |
|
| | The `FAISS_INDEX_PATH` is configured internally to `/app/faiss_index_store`. Note that in this single-container setup on HF Spaces, this path might be ephemeral unless specific persistent storage is configured for the Space. |
