Finforecaster / README.md
Starfish55's picture
Upload 8 files
c8c9a2c verified
---
title: FinGPT-Forecaster
emoji: πŸ“ˆ
colorFrom: blue
colorTo: green
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: AI-powered stock market prediction system
---
# FinGPT-Forecaster πŸ“ˆ
An AI-powered stock market prediction system that analyzes stock movements using advanced machine learning and financial data analysis.
## Features
- **Real-time Stock Analysis**: Get comprehensive analysis of any stock ticker
- **Technical Indicators**: RSI, Moving Averages, and price momentum analysis
- **News Sentiment Analysis**: Analyze recent news for market sentiment
- **Interactive Charts**: Visualize stock price movements with candlestick charts
- **Prediction Engine**: AI-powered predictions for next week's stock movement
- **Confidence Scoring**: Confidence levels for each prediction
## How to Use
1. **Enter Stock Symbol**: Input any valid stock ticker (e.g., AAPL, MSFT, NVDA)
2. **Configure Analysis**: Set the analysis period (30-365 days)
3. **Optional API Key**: Add your Finnhub API key for enhanced data (optional)
4. **Click Analyze**: Get comprehensive stock analysis and predictions
## Technical Analysis
The system uses multiple technical indicators:
- **RSI (Relative Strength Index)**: Identifies overbought/oversold conditions
- **Moving Averages**: 20-day and 50-day Simple Moving Averages
- **Price Momentum**: Weekly and monthly price changes
- **News Sentiment**: Keyword-based sentiment analysis of recent news
## Prediction Algorithm
The prediction engine combines:
1. **Technical Analysis**: RSI, moving averages, and momentum
2. **News Sentiment**: Positive/negative factors from recent news
3. **Market Performance**: Recent price movements and trends
4. **Confidence Scoring**: Weighted scoring system for prediction confidence
## Data Sources
- **Yahoo Finance**: Stock price data and historical information
- **Finnhub API**: Company profiles and news (optional, with API key)
- **Real-time Analysis**: Live market data processing
## Disclaimer
⚠️ **Important**: This tool is for educational and research purposes only. It should not be considered as financial advice. Always consult with qualified financial professionals before making investment decisions.
## API Configuration
To get enhanced data, you can add your Finnhub API key:
1. Sign up at [finnhub.io](https://finnhub.io)
2. Get your free API key
3. Enter it in the sidebar when using the app
## Built With
- **Streamlit**: Web application framework
- **Pandas**: Data manipulation and analysis
- **Matplotlib/mplfinance**: Financial charting
- **yfinance**: Yahoo Finance data
- **Finnhub**: Financial data API
- **Scikit-learn**: Machine learning utilities
## License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Support
For support, please open an issue in the repository or contact the development team.
---
**Powered by FinGPT Technology** | **Built with Streamlit** | **Open Source**