YBSener / financial_Agent

MIT License
28 stars 9 forks source link

šŸ“Š Professional Stock Analysis Dashboard

For more, you can check projects gif on this file: finagent.gif

šŸŒŸ Overview

Professional Stock Analysis Dashboard is a web application that allows users to analyze stocks using advanced machine learning models and financial tools. The application provides detailed insights into stock performance, technical analysis, fundamental analysis, and sentiment analysis from various sources.

āœØ Features

šŸš€ Installation

Prerequisites

Setup

  1. Clone the repository:

    git clone https://github.com/YBSener/financial_Agent.git
    cd financial_Agent
  2. Install the required Python packages:

    pip install -r requirements.txt
  3. Set up environment variables: Create a .env file in the project root and add the following environment variables:

    SERPER_API_KEY=your_serper_api_key
    OPENAI_API_KEY=your_openai_api_key
    REDDIT_CLIENT_ID=your_reddit_client_id
    REDDIT_CLIENT_SECRET=your_reddit_client_secret
    REDDIT_USER_AGENT=your_reddit_user_agent
    GROQ_API_KEY=your_groq_api_key

šŸ› ļø Usage

Running the Application

  1. Start the Streamlit app:

    streamlit run app.py
  2. Open your web browser

  3. Use the sidebar to configure your analysis:

    • Select the language model.
    • Enter the stock symbol.
    • Choose the time period and indicators.
  4. Click the "Analyze Stock" button to generate the report and visualize the stock data.

Application Structure

šŸ“Š Example Output

Investment Report: Apple Inc. (AAPL)

1. Executive Summary: Investment Recommendation

Given the current valuation metrics, slowing growth rates, and mixed technical indicators, a "hold" recommendation is advised for Apple Inc. (AAPL). While the company's strong brand and market position remain robust, the high P/E and P/B ratios suggest potential overvaluation, warranting caution for new investments.

2. Company Snapshot: Key Facts

3. Financial Highlights: Top Metrics and Peer Comparison

Apple's financial metrics reveal mixed signals:

4. Technical Analysis: Key Findings

Over the past year, AAPL's technical indicators show a generally bullish trend:

Despite the bullish trend, the current price is below key moving averages, suggesting potential short-term volatility.

5. Fundamental Analysis: Top Strengths and Concerns

Strengths:

Concerns:

6. Risk and Opportunity: Major Risk and Growth Catalyst

Major Risks:

Growth Catalysts:

7. Reddit Sentiment: Key Takeaway from Sentiment Analysis

Sentiment analysis from Reddit indicates a mixed view among retail investors. Out of 100 posts analyzed:

This suggests a generally cautious but neutral outlook among retail investors, with some acknowledging overvaluation concerns.

8. Investment Thesis: Bull and Bear Cases

Bull Case:

Bear Case:

9. Price Target: 12-Month Forecast

Based on current analyses and market conditions, a conservative price target for AAPL over the next 12 months is projected at $210, reflecting potential market corrections and growth risks, while allowing for a recovery towards the support level.

In conclusion, while Apple Inc. remains a strong player in the technology space, investors should approach with a "hold" strategy, carefully considering the high valuation and fluctuating market conditions.

šŸ¤ Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or new features.

šŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

šŸ“§ Contact

For any questions or support, please open an issue or contact (mailto:ybatu.sener@gmail.com).