README.md

metadata

title: Fed AI Savant
emoji: 💬
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.38.0
app_file: src/app.py
pinned: false
python_version: '3.11'
license: apache-2.0
short_description: A Fed savant to answer all your monetary policy questions

Fed AI Savant

An intelligent chatbot for analyzing Federal Reserve monetary policy and FOMC meeting minutes, powered by LLM-based agents and real-time data processing.

Setup

make setup  # Install uv, Python 3.11, create venv, and install dependencies

Create a .env file with your API key:

echo "FIREWORKS_API_KEY=your_api_key_here" > .env

Components

Data Pipeline (src/fed_scraper_pipeline/data_pipeline.py)

Scrapes FOMC meeting minutes from federalreserve.gov and processes them using LLM analysis to extract rate decisions, forward guidance, economic outlook, and market impact.

Run the pipeline:

python -m src.fed_scraper_pipeline.data_pipeline --max-meetings 25 --start-year 2022 --end-year 2025

Update recent meetings:

python -m src.fed_scraper_pipeline.update_recent_meetings --num-recent 2

Process from already scraped data:

python -m src.fed_scraper_pipeline.data_pipeline --from-scraped data/fed_meetings_scraped_YYYYMMDD_HHMMSS.json

Gradio App (src/app.py)

Interactive chat interface for querying Federal Reserve policy with AI-powered assistance, searchable FOMC meeting minutes, and real-time streaming responses.

Run the app:

make run

Or directly:

python -m src.app