metadata
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.