Agentic-AI-Stock-Analysis-Crew

KO | EN

gitlite — search

#python #typescript #android #machine-learning #deep-learning #linux #nodejs #windows #awesome #kubernetes #awesome-list #security #pytorch #openai

Agentic-AI-Stock-Analysis-Crew

(★ 25)

Exploring CrewAI capabilities by building a basic stock analysis app.

Agentic-AI-Stock-Analysis-Crew Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Agentic Stock Analysis System
![analyze-stock-example](https://github.com/user-attachments/assets/15f0c783-0e6c-45c2-8b30-e0bf4f027f8a)

This is an exploratory project to get familiar with CrewAI, an orchestration framework for agentic AI. It is built in pure python with a Streamlit frontend. The idea is to provide a free, intelligent stock analysis platform powered by a team of AI agents specializing in different aspects of market analysis. Investing should be accessible to everyone.
(This tool is for informational purposes only. Always conduct your own research and consult with financial advisors before making investment decisions. Feel free to extend this tool to your own needs.)

```mermaid
graph TD
    subgraph Agents
        MIO[Market Intelligence Officer]
        TAS[Technical Analysis Specialist]
        FAE[Fundamental Analysis Expert]
        RMS[Risk Management Specialist]
        PSE[Portfolio Strategy Expert]
    end

subgraph Tools
        ST[Search Tool]
        SDT[Stock Data Tool]
        FMT[Financial Metrics Tool]
    end

MIO --> ST
    MIO --> SDT
    TAS --> SDT
    FAE --> SDT
    FAE --> FMT
    RMS --> SDT
    RMS --> FMT
    PSE --> SDT
```

## Features

### Core Analysis
- **Multi-Agent System**: Five specialized agents working in concert:
  - Market Intelligence Officer: Market research and competitive analysis
  - Technical Analysis Specialist: Price patterns and technical indicators
  - Fundamental Analysis Expert: Financial statements and valuation
  - Risk Management Specialist: Risk assessment and mitigation
  - Portfolio Strategy Expert: Final investment recommendations

### Technical Capabilities
- **Real-time Progress Updates**: Live feedback from agents during analysis
- **Retry Mechanism**: Automatic retry for API calls with exponential backoff
- **Error Handling**: Comprehensive error management across all operations
- **Data Visualization**: Interactive charts and metrics display
- **Responsive Dashboard**: Modern, user-friendly interface

### Analysis Components
- **Market Research**: Industry position, competitive advantages, and market trends
- **Technical Analysis**: Multi-timeframe analysis, support/resistance levels, and indicators
- **Fundamental Analysis**: Financial statements, valuation methods, and growth metrics
- **Risk Assessment**: Volatility analysis, VaR calculations, and stress testing
- **Investment Strategy**: Position sizing, entry/exit points, and portfolio context

### Dashboard Features
- **Interactive Charts**: 
  - Candlestick charts with volume analysis
  - Technical indicators (RSI, MACD)
  - Moving averages
- **Financial Metrics**: 
  - Profitability ratios
  - Valuation metrics
  - Growth indicators
- **Risk Metrics**:
  - Volatility analysis
  - Value at Risk (VaR)
  - Sharpe Ratio
  - Risk level assessment
- **Educational Resources**: 
  - Investment terms glossary
  - Technical analysis explanations
  - Financial metrics definitions

## Installation

1. Clone the repository:
```bash
git clone https://github.com/yourusername/agentic-stock-analysis.git
cd agentic-stock-analysis
```

2. Install dependencies:
```bash
pip install -r requirements.txt
```

3. Set up environment variables:
```bash
cp .env.example .env
# Edit .env with your API keys
```

## Usage

Run the dashboard:
```bash
streamlit run dashboard.py
```

Enter a stock ticker and click "Analyze Stock" to receive:
- Market data visualization
- Technical analysis
- Fundamental analysis
- Investment recommendations

## Project Structure

```
stock-analyst-ai/
├── market_analysis_crew.py  # AI agent implementation
├── dashboard.py            # Streamlit interface
├── requirements.txt       # Dependencies
└── .env                  # Configuration
```

## Quick Start

### 1. Installation
```bash
git clone <repository>
cd Agentic-AI-Stock-Analysis-Crew
pip install -r requirements.txt
```

### 2. Configuration
Copy the example environment file and add your API keys:
```bash
cp .env.example .env
```

Edit `.env` with your API keys (you only need one):
```env
# Choose one or more providers:
OPENAI_API_KEY=your_openai_api_key_here        # $5 free credits
ANTHROPIC_API_KEY=your_anthropic_api_key_here  # Free tier available  
GEMINI_API_KEY=your_gemini_api_key_here        # Free API key
# Or use local Ollama (completely free)
```

### 3. Run the Application
```bash
streamlit run dashboard.py
```

## Supported AI Models

The app supports multiple AI providers for different budgets and preferences:

| Provider | Models | Cost | Free Option | Setup Link |
|----------|--------|------|-------------|------------|
| **OpenAI** | GPT-4o, GPT-4, GPT-3.5-turbo | $0.01-$0.06/1K tokens | $5 free credits | [Get API Key](https://platform.openai.com/signup) |
| **Anthropic** | Claude 3.5 Sonnet, Claude 3 Haiku | $0.25-$3.00/1K tokens | Free tier | [Get API Key](https://console.anthropic.com/) |
| **Google** | Gemini 1.5 Pro, Gemini 1.5 Flash | $0.075-$7.00/1K tokens | Free API key | [Get API Key](https://makersuite.google.com/app/apikey) |
| **Ollama** | Llama 3.2, Mistral, CodeLlama | Free | Always free | [Download Ollama](https://ollama.ai/) |

## Dependencies

- crewai (https://docs.crewai.com/introduction)
- streamlit (https://streamlit.io/)
- yfinance (https://pypi.org/project/yfinance/)
- plotly (https://plotly.com/)
- pandas (https://pandas.pydata.org/)
- python-dotenv (https://pypi.org/project/python-dotenv/)

## Contributing

This is a work in progress, and contributions are welcome! Please feel free to submit issues and pull requests.

## License

MIT License

## Disclaimer

This tool is for informational purposes only. Always conduct your own research and consult with financial advisors before making investment decisions.

Agentic-AI-Stock-Analysis-Crew

Agentic-AI-Stock-Analysis-Crew Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Agentic-AI-Stock-Analysis-Crew

Agentic-AI-Stock-Analysis-Crew Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README