FinancialAnalystAIAgent

# Stock Analysis Dashboard & Financial Analyst Agent

An advanced, AI-powered financial analysis tool that combines market data retrieval, technical charting, and natural language insights. This project leverages cutting-edge technologies and frameworks to deliver sophisticated analyses, actionable recommendations, and comprehensive market insights—all within an interactive dashboard.

---

## Table of Contents

- [Overview](#overview)
- [Demo](#demo)
- [Key Features](#key-features)
- [Architecture](#architecture)
- [Technologies & Frameworks](#technologies--frameworks)
- [Installation & Setup](#installation--setup)
- [Usage](#usage)
- [Configuration](#configuration)
- [File Structure](#file-structure)
- [Author](#author)
- [License](#license)

---

## Overview

This project provides a complete solution for stock analysis by integrating historical market data, interactive visualizations, and AI-driven insights. At its core is the **Financial Analyst Agent**, which leverages the power of **Google Gemini 2.0 Flash** to process user queries, assess market trends, and generate clear, actionable recommendations. The accompanying **Streamlit** dashboard offers an intuitive user interface to explore stock data, visualize candlestick charts, and interact with the AI agent.

---

## Demo

Below is a quick demonstration of how the Stock Analysis Dashboard works:

![Stock Analysis Dashboard Demo](demo/demo.gif)

---

## Key Features

- **Real-Time Stock Data:** Integrates with **Yahoo Finance** to fetch up-to-date market data.
- **Interactive Visualizations:** Utilizes **Plotly** to generate dynamic candlestick charts and data tables.
- **AI-Driven Analysis:** Powered by **Google Gemini 2.0 Flash**, offering detailed insights, risk assessments, and investment strategies.
- **Configurable Parameters:** Customizable parameters through a YAML configuration file for ease of updates and modifications.
- **Analyst Recommendations:** Combines historical data with AI analytics to prov