| | --- |
| | title: FinancialPlatform |
| | emoji: 📈 |
| | colorFrom: blue |
| | colorTo: green |
| | sdk: docker |
| | app_port: 7860 |
| | pinned: false |
| | license: apache-2.0 |
| | short_description: Multi-asset analysis with OpenBB and AI insights |
| | --- |
| | |
| | # Financial Analysis Platform |
| |
|
| | A comprehensive multi-asset financial analysis platform built with Streamlit, providing real-time data, technical indicators, and AI-powered insights. |
| |
|
| | ## Features |
| |
|
| | ### 📈 Stock Analysis |
| | - Real-time stock price data from OpenBB |
| | - Technical indicators (SMA, EMA, RSI) |
| | - Company profile and financial statements |
| | - Revenue and net income trends |
| | - TradingView chart integration |
| | - Profitability metrics analysis |
| |
|
| | ### ₿ Cryptocurrency (Coming Soon) |
| | - Real-time cryptocurrency prices |
| | - Market cap and 24h volume |
| | - Technical indicators for crypto assets |
| | - TradingView crypto charts |
| |
|
| | ### 💱 Forex Trading (Coming Soon) |
| | - Foreign exchange rate analysis |
| | - Major, minor, and exotic pairs |
| | - Pip calculator |
| | - Economic calendar integration |
| |
|
| | ### 🔍 Market Screener (Coming Soon) |
| | - Multi-criteria filtering |
| | - Technical pattern recognition |
| | - Sort by volume, price change, RSI |
| | - Export results to CSV |
| |
|
| | ### 📰 News & AI Dashboard ✅ LIVE |
| | - **23 Premium Sources** across 4 tiers for comprehensive coverage |
| | - **Tier 1**: Bloomberg (×2), Reuters, FT, WSJ, The Economist, CNBC, MarketWatch (8 sources) |
| | - **Tier 2**: BBC World, AFP, Al Jazeera, Politico, DW News (5 sources) |
| | - **Tier 3**: Federal Reserve (2.0x), ECB (2.0x), Lagarde, BoE, IMF, World Bank, US Treasury (7 sources) |
| | - **Tier 4**: Zero Hedge, First Squawk, Live Squawk (3 sources) |
| | - **Low-latency monitoring** with 3-minute cache for trading decisions |
| | - **Intelligent categorization**: Macro, Markets, Geopolitical |
| | - **Professional sentiment analysis** (Positive/Negative/Neutral) |
| | - **Weighted impact scoring**: Source credibility × engagement × recency |
| | - **Breaking news detection** with instant alerts and priority display |
| | - **Smart filtering** by category, sentiment, and impact level |
| | - **Auto-refresh mode** for continuous monitoring during trading hours |
| | - Powered by **Twikit** for real-time Twitter/X intelligence (free, no API costs) |
| |
|
| | ## Installation |
| |
|
| | 1. Clone the repository: |
| | ```bash |
| | git clone <repository-url> |
| | cd FinancialPlatform |
| | ``` |
| |
|
| | 2. Install dependencies: |
| | ```bash |
| | pip install -r requirements.txt |
| | ``` |
| |
|
| | 3. Create a `.env` file based on `.env.example`: |
| | ```bash |
| | cp .env.example .env |
| | ``` |
| |
|
| | 4. Configure your API keys and Twitter credentials in `.env`: |
| | ``` |
| | DEEPSEEK_API_KEY=your-key-here |
| | NEWS_SERVICE_URL=http://localhost:5000 |
| | ALPHA_VANTAGE_KEY=your-key-here |
| | |
| | # Twitter/X Credentials (required for real-time news monitoring) |
| | TWITTER_USERNAME=your-twitter-username |
| | TWITTER_EMAIL=your-email@example.com |
| | TWITTER_PASSWORD=your-password |
| | ``` |
| |
|
| | **Note**: Twitter credentials are required for real-time news monitoring. Without credentials, the system will use demo/mock data. |
| |
|
| | ## Usage |
| |
|
| | Run the application: |
| | ```bash |
| | streamlit run app/app.py |
| | ``` |
| |
|
| | The application will open in your default web browser at `http://localhost:8501`. |
| |
|
| | ## Project Structure |
| |
|
| | ``` |
| | FinancialPlatform/ |
| | ├── app/ |
| | │ ├── app.py # Main landing page |
| | │ ├── pages/ |
| | │ │ ├── 01_Stocks.py # Stock analysis page |
| | │ │ ├── 02_Crypto.py # Cryptocurrency analysis |
| | │ │ ├── 03_Forex.py # Forex analysis |
| | │ │ ├── 04_Screener.py # Market screener |
| | │ │ └── 05_Dashboard.py # News & AI dashboard |
| | │ ├── components/ |
| | │ │ ├── chart.py # Chart creation utilities |
| | │ │ ├── data_sources.py # Data fetching functions |
| | │ │ ├── ui.py # UI component functions |
| | │ │ └── styles.py # Dark theme CSS |
| | │ └── utils/ |
| | │ ├── config.py # Configuration management |
| | │ └── formatters.py # Data formatting utilities |
| | ├── requirements.txt |
| | ├── .env.example |
| | └── README.md |
| | ``` |
| |
|
| | ## Technology Stack |
| |
|
| | - **Frontend**: Streamlit |
| | - **Data Sources**: OpenBB SDK, yfinance |
| | - **Charting**: Plotly, TradingView widgets |
| | - **AI**: DeepSeek API (planned) |
| | - **Styling**: Custom CSS with dark theme |
| |
|
| | ## Features in Development |
| |
|
| | - [ ] Cryptocurrency data integration (Binance API) |
| | - [ ] Forex data integration (Alpha Vantage) |
| | - [ ] Market screener with advanced filters |
| | - [ ] News aggregation service |
| | - [ ] AI-powered trading insights |
| | - [ ] Sentiment analysis |
| | - [ ] Additional technical indicators (MACD, Bollinger Bands, ATR) |
| |
|
| | ## Configuration |
| |
|
| | ### Environment Variables |
| |
|
| | - `DEEPSEEK_API_KEY`: API key for AI-powered insights |
| | - `NEWS_SERVICE_URL`: URL for news aggregation service |
| | - `ALPHA_VANTAGE_KEY`: API key for forex data (optional) |
| |
|
| | ### Cache Settings |
| |
|
| | Data caching is configured in `utils/config.py`: |
| | - Price data: 1 hour TTL |
| | - Fundamental data: 24 hours TTL |
| | - News data: 15 minutes TTL |
| |
|
| | ## Deployment |
| |
|
| | ### HuggingFace Spaces |
| |
|
| | This application is optimized for deployment on HuggingFace Spaces: |
| |
|
| | 1. Create a new Space on HuggingFace |
| | 2. Set the Space type to "Streamlit" |
| | 3. Add your environment variables in the Space settings: |
| | - `DEEPSEEK_API_KEY` |
| | - `NEWS_SERVICE_URL` |
| | - `ALPHA_VANTAGE_KEY` |
| | 4. Push your code to the Space repository |
| |
|
| | ### Local Development |
| |
|
| | For local development with hot-reload: |
| | ```bash |
| | streamlit run app/app.py --server.runOnSave=true |
| | ``` |
| |
|
| | ## Contributing |
| |
|
| | Contributions are welcome! Please feel free to submit a Pull Request. |
| |
|
| | ## License |
| |
|
| | Apache 2.0 License |
| |
|
| | ## Acknowledgments |
| |
|
| | - OpenBB for financial data API |
| | - TradingView for chart widgets |
| | - Streamlit for the amazing web framework |
| |
|
