Feel the pulse of the market with AI-powered stock insights.

Vibe Coded with Amazon Q Developer CLI in 1 hour!

Stock Pulse is a Python tool that analyzes stocks using financial metrics, news trends, and AI-powered sentiment analysis. It provides investment recommendations (BUY, SELL, HOLD) with detailed reasoning based on comprehensive analysis.

• Analyze multiple stocks at once
• Fetch financial metrics and news data using yfinance
• Utilize OpenAI's GPT-4o-mini model for intelligent analysis
• Generate investment signals with detailed reasoning
• Identify key factors and potential risks
• Command-line interface and Streamlit web UI

1. Clone the repository:

   git clone https://github.com/yourusername/stock-pulse.git
   cd stock-pulse
   

2. Install dependencies using Poetry:

   poetry install
   

3. Create a .env file with your OpenAI API key:

   cp .env.example .env
   

   Then edit the .env file to add your OpenAI API key.

Analyze stocks using the command line:

# Analyze a single stock
poetry run python main.py AAPL

# Analyze multiple stocks
poetry run python main.py AAPL MSFT GOOGL AMZN

# Output results in JSON format
poetry run python main.py AAPL MSFT --json

Run the Streamlit web interface:

poetry run streamlit run streamlit_app.py

Then open your browser to the URL shown in the terminal (typically http://localhost:8501).

stock-pulse/
├── stock_pulse/
│   ├── core/           # Core functionality
│   ├── models/         # LLM models
│   ├── utils/          # Utility functions
│   ├── config/         # Configuration
│   ├── ui/             # Streamlit UI
│   └── cli.py          # Command-line interface
├── main.py             # CLI entry point
├── streamlit_app.py    # Streamlit entry point
├── pyproject.toml      # Poetry configuration
└── README.md           # Documentation

• Python 3.8+
• OpenAI API key
• Internet connection for fetching stock data

MIT