README.md

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

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

Create a `.env` file with your API key:
```bash
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:**
```bash
python -m src.fed_scraper_pipeline.data_pipeline --max-meetings 25 --start-year 2022 --end-year 2025
```

**Update recent meetings:**
```bash
python -m src.fed_scraper_pipeline.update_recent_meetings --num-recent 2
```

**Process from already scraped data:**
```bash
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:**
```bash
make run
```

Or directly:
```bash
python -m src.app
```